Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Productivity - official Todoist (Doist) server

Todoist MCP server

Hosted and local MCP server from Doist that lets AI agents read, create, update, complete and reschedule Todoist tasks, projects, sections, labels, filters, reminders and comments. The same tools are also published as an npm library for use outside MCP. Todoist (Doist) hosts it at https://ai.todoist.net/mcp, or you can run @doist/todoist-mcp (npm) locally with OAuth or API key auth.

Last verified 15 tools11 sources

Install

Claude Code

About Claude Code
Terminal
claude mcp add --transport http todoist https://ai.todoist.net/mcp

Cursor

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

VS Code

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

Generic

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

Tools

find-tasks
Find tasks by text search, project/section/parent container, responsible user, labels, a raw Todoist filter string, or a saved filter.
find-tasks-by-date
Get tasks by date range; startDate='today' includes overdue items.
add-tasks
Create one or more tasks with title, description, due date and placement.
update-tasks
Modify existing tasks (name, description, due string, project and more).
complete-tasks
Complete one or more tasks by their IDs.
reschedule-tasks
Reschedule tasks to new dates while preserving recurring schedules.
find-projects
List all projects or search for projects by name, optionally including archived projects.
add-projects
Create new projects.
add-comments
Add comments to tasks or projects, optionally notifying collaborators.
find-comments
Find comments by task, project, or get a specific comment by ID.
get-overview
Get a Markdown overview of the account's project and section structure, or of one project's tasks grouped by section.
find-activity
Query the account activity log.
search
Search across tasks and projects; returns results with IDs, titles, and URLs (OpenAI MCP compatible).
fetch
Fetch the full contents of a task or project by ID (OpenAI MCP compatible).
user-info
Get user ID, name, email, timezone, week start, goal progress and plan.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Hosted endpoint uses OAuth (data:read_write scope); the local npm stdio server (npx @doist/todoist-mcp) needs a TODOIST_API_KEY.
  • Todoist says connecting via the MCP server is available on all plans.
  • Repo was previously named Doist/todoist-ai; npm package was renamed to @doist/todoist-mcp (v13.6.0 published 2026-10-16).
  • Claude Code alternative: official plugin via '/plugin marketplace add doist/todoist-mcp' then '/plugin install todoist@doist'.
  • Codex is documented only through the ChatGPT Todoist plugin, so no Codex snippet.
  • The docs point to src/tools for the full tool list (40+ tools, including filters, labels, reminders, sections, workspaces, assignments and project templates); descriptions above are from the tool source.
  • Includes MCP Apps widgets.

More MCP servers for productivity

Related reading

FAQ

What does the Todoist MCP server do?

Hosted and local MCP server from Doist that lets AI agents read, create, update, complete and reschedule Todoist tasks, projects, sections, labels, filters, reminders and comments. The same tools are also published as an npm library for use outside MCP. The vendor documents 15 tools, including find-tasks, find-tasks-by-date, add-tasks and update-tasks.

How do I add the Todoist MCP server to Claude Code?

Run claude mcp add --transport http todoist https://ai.todoist.net/mcp, copied from Todoist (Doist)'s docs. This page also has snippets for Cursor, VS Code and Generic.

Does the Todoist MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP, stdio. Status: GA, last checked October 17, 2026.

Sources

Last verified against 11 Todoist (Doist) pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.