Todoist MCP server
Doist's official Todoist MCP server lets agents create, find, update, and complete tasks, projects, sections, labels, reminders, and goals.
The Todoist MCP Server is the official server from Doist, the company behind Todoist, that lets an AI agent manage your tasks and projects on your behalf. It is a broad surface rather than a thin wrapper: the agent can add, find, update, reschedule, complete, and uncomplete tasks; create and reorganize projects, sections, labels, and filters; manage comments, reminders, and collaborators; and work with goals, including linking goals to the tasks that advance them. On top of the CRUD tools it ships workflow helpers, get-overview pulls a snapshot of what is on your plate, find-tasks-by-date drives daily and weekly planning, and a set of analytics tools (productivity stats, project health, workspace insights) lets the agent report on how work is going. Generic search and fetch tools follow the OpenAI MCP convention for broad client compatibility.
The recommended setup is the hosted remote endpoint at https://ai.todoist.net/mcp, which uses OAuth: the first time the agent calls a Todoist tool, an authorization window opens in your browser, so no API token is stored. For local or headless use you can run the @doist/todoist-mcp package over stdio and authenticate with a Todoist API token in the TODOIST_API_KEY environment variable.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"todoist": {
"type": "http",
"url": "https://ai.todoist.net/mcp"
}
}
}claude mcp add --transport http todoist https://ai.todoist.net/mcpHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| add-tasks | Creates one or more tasks. |
| update-tasks | Updates fields on existing tasks. |
| find-tasks | Finds tasks matching the given criteria. |
| find-tasks-by-date | Finds tasks scheduled for a specific date or date range. |
| find-completed-tasks | Finds tasks that have already been completed. |
| complete-tasks | Marks one or more tasks as complete. |
| uncomplete-tasks | Reopens previously completed tasks. |
| reschedule-tasks | Changes the due date of one or more tasks. |
| add-projects | Creates one or more projects. |
| update-projects | Updates fields on existing projects. |
| find-projects | Finds projects matching the given criteria. |
| project-management | Performs higher-level project management operations. |
| project-move | Moves a project within the project hierarchy. |
| add-sections | Creates sections within a project. |
| update-sections | Updates existing sections. |
| find-sections | Finds sections within projects. |
| add-labels | Creates labels. |
| update-labels | Updates existing labels. |
| find-labels | Finds labels matching the given criteria. |
| add-filters | Creates saved filters. |
| update-filters | Updates existing filters. |
| find-filters | Finds saved filters. |
| add-comments | Adds comments to tasks or projects. |
| update-comments | Updates existing comments. |
| find-comments | Finds comments on tasks or projects. |
| add-reminders | Creates reminders for tasks. |
| update-reminders | Updates existing reminders. |
| find-reminders | Finds reminders. |
| add-goals | Creates goals. |
| update-goals | Updates existing goals. |
| find-goals | Finds goals matching the given criteria. |
| complete-goals | Marks goals as complete. |
| link-goal-tasks | Links tasks to a goal so progress can be tracked. |
| manage-assignments | Assigns or reassigns tasks to collaborators. |
| find-project-collaborators | Lists the collaborators on a project. |
| view-attachment | Views an attachment on a task or comment. |
| list-workspaces | Lists the workspaces the user belongs to. |
| get-overview | Returns a snapshot overview of the user's current tasks and projects. |
| get-productivity-stats | Returns the user's productivity statistics. |
| get-project-health | Reports the health of a project. |
| get-project-activity-stats | Returns activity statistics for a project. |
| analyze-project-health | Analyzes a project's health and surfaces issues. |
| get-workspace-insights | Returns insights across a workspace. |
| find-activity | Finds activity log events. |
| reorder-objects | Reorders tasks, projects, or sections. |
| delete-object | Deletes a Todoist object such as a task, project, or section. |
| fetch-object | Fetches a specific Todoist object by ID. |
| user-info | Returns information about the authenticated user. |
| search | Searches across Todoist, following the OpenAI MCP convention. |
| fetch | Fetches a resource by ID, following the OpenAI MCP convention. |
Required configuration
- TODOIST_API_KEYRequired
Todoist API token, used by the local stdio server when not using the OAuth remote endpoint.
What you can do with it
Plan the day from chat
Ask the agent what is due today and it calls find-tasks-by-date and get-overview, then reschedules or completes items as you talk through your plan.
Capture work as it comes up
During a meeting or while coding, the agent adds tasks, assigns them to collaborators, and files them under the right project and section without you leaving the conversation.
FAQ
- Is it free?
- Yes. The Todoist MCP server is open source and free to run; it works within your existing Todoist account, and Todoist's own free and paid plan limits apply.
- Does it support remote/OAuth?
- Yes. The recommended deployment is the hosted remote endpoint at https://ai.todoist.net/mcp with OAuth, which opens a browser authorization window on first use. A local @doist/todoist-mcp stdio server using a TODOIST_API_KEY token is also available.
- Is this the official Todoist server?
- Yes. It is published by Doist, the company that makes Todoist, in the Doist/todoist-ai repository (formerly todoist-mcp).