Todoist

TodoistTools enables an Agent to interact with Todoist.

Prerequisites

The following example requires the todoist-api-python library. and a Todoist API token which can be obtained from the Todoist Developer Portal.

uv pip install todoist-api-python

export TODOIST_API_TOKEN=***

Example

The following agent will create a new task in Todoist.

cookbook/14_tools/todoist.py

"""
Example showing how to use the Todoist Tools with Agno

Requirements:
- Sign up/login to Todoist and get a Todoist API Token (get from https://app.todoist.com/app/settings/integrations/developer)
- uv pip install todoist-api-python

Usage:
- Set the following environment variables:
    export TODOIST_API_TOKEN="your_api_token"

- Or provide them when creating the TodoistTools instance
"""

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.todoist import TodoistTools

todoist_agent = Agent(
    name="Todoist Agent",
    role="Manage your todoist tasks",
    instructions=[
        "When given a task, create a todoist task for it.",
        "When given a list of tasks, create a todoist task for each one.",
        "When given a task to update, update the todoist task.",
        "When given a task to delete, delete the todoist task.",
        "When given a task to get, get the todoist task.",
    ],
    id="todoist-agent",
    model=OpenAIResponses(id="gpt-5.2"),
    tools=[TodoistTools()],
    markdown=True,
    debug_mode=True,
    )

# Example 1: Create a task
print("\n=== Create a task ===")
todoist_agent.print_response("Create a todoist task to buy groceries tomorrow at 10am")

# Example 2: Delete a task
print("\n=== Delete a task ===")
todoist_agent.print_response(
    "Delete the todoist task to buy groceries tomorrow at 10am"
)

# Example 3: Get all tasks
print("\n=== Get all tasks ===")
todoist_agent.print_response("Get all the todoist tasks")

Toolkit Params

Parameter	Type	Default	Description
api_token	str	None	If you want to manually supply the TODOIST_API_TOKEN.

Toolkit Functions

Function	Description
create_task	Creates a new task in Todoist with optional project assignment, due date, priority, and labels.
get_task	Fetches a specific task.
update_task	Updates an existing task with new properties such as content, due date, priority, etc.
close_task	Marks a task as completed.
delete_task	Deletes a specific task from Todoist.
get_active_tasks	Retrieves all active (non-completed) tasks.
get_projects	Retrieves all projects in Todoist.

You can use include_tools or exclude_tools to modify the list of tools the agent has access to. Learn more about selecting tools.

Developer Resources

• View Tools