Todoist MCP Server

Official Todoist MCP server from Doist for managing tasks, projects, labels, filters, comments, and reminders in Todoist via natural language.

Project Management by Doist OAuth2 active

Connect (Remote Server) GitHub Docs npm: @doist/todoist-ai

Overview

Todoist AI is the official MCP server built and maintained by Doist, the makers of Todoist. It connects AI agents to a user's Todoist account so language models can read and modify tasks, projects, sections, labels, filters, comments, and reminders. It can be used as a remote MCP server hosted at https://ai.todoist.net/mcp or installed as the npm package @doist/todoist-ai and used as importable modules in frameworks like Vercel's AI SDK.

The server exposes roughly 45 tools covering the full Todoist surface: creating and updating tasks, completing and rescheduling them, managing project hierarchies, working with labels, filters, sections, comments, reminders, and collaborators, plus analytics tools like productivity stats, project health, and workspace insights. The tools are designed to enable complete workflows rather than atomic actions, balancing flexibility with LLM efficiency. The server also supports MCP Apps for interactive UI widgets and provides search and fetch tools that follow the OpenAI MCP specification.

Authentication uses browser-based OAuth on first connection, so no API key wrangling is required when using the hosted endpoint. The project is open source under Doist's GitHub org and is actively expanding.

Tools

Tool	Description
`add-tasks`	Create one or more tasks with content, due dates, priorities, labels, and project assignment.
`find-tasks`	Search active tasks by filter, project, label, or query.
`find-tasks-by-date`	Retrieve tasks scheduled on or around a specific date.
`update-tasks`	Edit content, due date, priority, labels, or other fields on existing tasks.
`complete-tasks`	Mark one or more tasks as completed.
`uncomplete-tasks`	Reopen previously completed tasks.
`reschedule-tasks`	Move tasks to new due dates in bulk.
`find-completed-tasks`	Query completed tasks in a project or time range.
`add-projects`	Create new projects.
`find-projects`	List or search projects.
`update-projects`	Rename, recolor, or restructure projects.
`project-move`	Move a project under a different parent or workspace.
`project-management`	Higher-level project workflow actions.
`find-project-collaborators`	List people sharing a project.
`manage-assignments`	Assign or unassign tasks to collaborators.
`add-sections`	Create sections inside a project.
`find-sections`	List sections in a project.
`update-sections`	Rename or reorder sections.
`add-labels`	Create labels.
`find-labels`	List existing labels.
`update-labels`	Rename or recolor labels.
`add-filters`	Create saved filters.
`find-filters`	List saved filters.
`update-filters`	Edit saved filter queries.
`add-comments`	Post comments on tasks or projects.
`find-comments`	Read comments for a task or project.
`update-comments`	Edit existing comments.
`add-reminders`	Create reminders on tasks.
`find-reminders`	List reminders.
`update-reminders`	Edit reminder timing or type.
`delete-object`	Delete a task, project, section, label, filter, comment, or reminder.
`reorder-objects`	Reorder projects, sections, or tasks.
`fetch-object`	Fetch a single object by ID.
`fetch`	OpenAI-compatible fetch tool to retrieve a record by ID.
`search`	OpenAI-compatible search tool across Todoist content.
`find-activity`	Query the activity log across the account.
`get-overview`	Return a high-level overview of the user's Todoist.
`get-productivity-stats`	Return karma and completion stats.
`get-project-activity-stats`	Return activity stats for a project.
`get-project-health`	Report on the health of a project (stale tasks, overdue, etc.).
`analyze-project-health`	Deeper analytical view of project health.
`get-workspace-insights`	Return workspace-level insights.
`list-workspaces`	List workspaces the user belongs to.
`user-info`	Return the authenticated user's info.
`view-attachment`	View attachments on tasks or comments.

Setup Guide

Todoist hosts the MCP server at https://ai.todoist.net/mcp. Authentication is OAuth, performed in your browser the first time you use a tool, no API key required.

Claude Desktop

Settings → Connectors → Add custom connector, then use:

https://ai.todoist.net/mcp

Cursor (~/.cursor/mcp.json or .cursor/mcp.json)

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
    }
  }
}

VS Code

{
  "servers": {
    "todoist": {
      "type": "http",
      "url": "https://ai.todoist.net/mcp"
    }
  }
}

Claude Code (CLI)

/plugin marketplace add doist/todoist-ai

Any other MCP client

npx -y mcp-remote https://ai.todoist.net/mcp

Self-host or use as a library

npm install @doist/todoist-ai

When used as a library, set TODOIST_API_KEY and wrap the tools with a Todoist client. Running npx @doist/todoist-ai launches the MCP server locally.

Use Cases

Capture tasks from chat or email threads into the right Todoist project with due dates, labels, and priorities in a single step.
Run a weekly review by pulling overdue tasks, completed tasks, productivity stats, and project health, then rescheduling or reprioritizing in bulk.
Triage shared projects: list collaborators, assign tasks, post comments, and create reminders for teammates.
Use natural language to maintain project structure: create sections, reorder tasks, move projects, and tidy up labels and filters.
Generate daily or weekly summaries from get-overview, find-tasks-by-date, and get-productivity-stats for standups or personal planning.

Example Prompts

"Add a task to my Work project: ‘Draft Q3 OKRs’ due Friday at 3pm with priority 2 and label @planning."
"Show me everything due this week across all projects, grouped by project."
"Reschedule all overdue tasks in the Marketing project to next Monday."
"Summarize my completed tasks from last week and give me my productivity stats."
"Create a project called ‘Launch Plan’ with sections Research, Build, and Ship, and add the top five tasks I mentioned above."

Pros

Official server from Doist, kept in sync with the Todoist platform.
Very broad coverage: roughly 45 tools spanning tasks, projects, sections, labels, filters, comments, reminders, collaborators, and analytics.
Hosted endpoint at https://ai.todoist.net/mcp with browser-based OAuth, no API token setup needed.
Reusable as a library outside MCP (Vercel AI SDK and similar frameworks).

Limitations

Project is marked early-stage in the README, so tool surface and behavior may shift.
Requires mcp-remote shim for clients that do not natively support streamable HTTP MCP servers.
Some Todoist features (such as deep workspace administration) are exposed through generic tools like delete-object and project-management, which may need careful prompting.

Alternatives

abhiz123/todoist-mcp-server: community-built Todoist MCP server using an API token.
TickTick MCP servers: community alternatives for users on TickTick instead of Todoist.
Linear or Asana MCP servers if your workflow lives in a team project management tool rather than Todoist.