Todoist MCP (official, Doist)
OfficialDoist's official Todoist MCP server — manage tasks, projects, and labels on your behalf.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @doist/todoist-mcpPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"todoist-mcp-official-doist": {
"command": "npx",
"args": [
"-y",
"@doist/todoist-mcp"
],
"env": {
"TODOIST_API_KEY": "<your-todoist-api-key>"
}
}
}
}Before you start
- Node.js (an .nvmrc pins the supported version; Node 18+ recommended) if running the npm package locally
- A Todoist account
- For local/stdio use: a Todoist API token from Todoist → Settings → Integrations → Developer, set as the TODOIST_API_KEY environment variable
- For the hosted remote endpoint (https://ai.todoist.net/mcp): no token needed — OAuth runs in the browser on first use
About Todoist MCP (official, Doist)
The official Todoist MCP server, built and maintained by Doist (the company behind Todoist). It lets an AI agent read and modify your Todoist account on your behalf — creating and completing tasks, organizing projects and sections, managing labels, filters, reminders, and comments, and pulling productivity insights.
Unlike most community servers, this one is comprehensive: it wraps a large surface of the Todoist API across tasks, projects, labels, sections, comments, filters, reminders, goals, and workspace/productivity analytics. It also ships OpenAI-compatible search and fetch tools so it works with agents beyond Claude.
It can run locally over stdio (set TODOIST_API_KEY) or you can connect to Doist's hosted remote endpoint at https://ai.todoist.net/mcp (Streamable HTTP), where OAuth runs in your browser on first use — no manual token handling required.
Tools & capabilities (14)
add-tasksCreate one or more tasks with content, due dates, priority, labels, and project/section.
find-tasksFind tasks by query, filtering by project, label, or other attributes.
find-tasks-by-dateFind tasks scheduled for a given date or date range.
update-tasksUpdate existing tasks (content, due date, priority, etc.).
complete-tasksMark tasks as complete (and uncomplete-tasks to reopen them).
reschedule-tasksMove tasks to new due dates.
add-projects / find-projects / update-projectsCreate, list, and edit projects; project-move and project-management for restructuring.
add-sections / update-sections / find-sectionsManage sections within projects.
add-labels / find-labels / update-labelsCreate, list, and edit labels.
add-comments / find-comments / update-commentsAdd and manage task/project comments.
add-filters / find-filters / update-filtersCreate and manage Todoist filters.
add-reminders / find-reminders / update-remindersCreate and manage task reminders.
get-overview / get-productivity-stats / get-project-healthPull productivity stats, project health, and workspace insights.
search / fetchOpenAI-MCP-compatible search and fetch tools for cross-agent compatibility.
When to use it
- Use it when you want an agent to fully manage Todoist — not just tasks, but projects, sections, labels, filters, and reminders.
- Use it when you'd rather connect to a hosted, OAuth-secured endpoint than juggle API tokens in a local config.
- Use it when you want productivity analytics (project health, completion stats, workspace insights) surfaced in chat.
- Use it when you need OpenAI-compatible search/fetch tools so the same server works across multiple AI clients.
- Use it when you want official vendor support and an API surface that tracks Todoist features closely.
Quick setup
- 1Decide between local (stdio) or the hosted remote endpoint at https://ai.todoist.net/mcp.
- 2For local: get a Todoist API token from Settings → Integrations → Developer.
- 3Add the server to your client config — e.g. command `npx`, args `@doist/todoist-mcp`, with env `TODOIST_API_KEY` set (or point at the remote URL for OAuth).
- 4Restart your MCP client (Claude Desktop, Cursor, Claude Code, or VS Code).
- 5If using the remote endpoint, complete the browser OAuth flow the first time a Todoist tool is called.
- 6Verify by asking the agent to list today's tasks or create a test task.
Security notes
The TODOIST_API_KEY grants full read/write access to your tasks and projects, so store it in env vars and revoke it from Todoist settings if leaked. The hosted ai.todoist.net option uses OAuth and avoids storing the key locally.
Todoist MCP (official, Doist) FAQ
Is this the official Todoist MCP server?
Yes. It's published under the @doist npm scope and maintained by Doist, the company that makes Todoist.
Do I need an API token, or can I use OAuth?
Both work. The local npm package uses a TODOIST_API_KEY from Settings → Integrations → Developer; the hosted endpoint at ai.todoist.net/mcp uses browser OAuth on first use.
What's the npm package name?
@doist/todoist-mcp. It was previously published as @doist/todoist-ai.
Does it work with clients other than Claude?
Yes. It includes OpenAI-MCP-compatible search and fetch tools and documents setup for Claude Desktop, Cursor, Claude Code, and VS Code.
Can it manage more than tasks?
Yes — it covers projects, sections, labels, comments, filters, reminders, and productivity/workspace analytics, not just task CRUD.
Alternatives to Todoist MCP (official, Doist)
Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.
Official Notion server to read, search, create, and update pages and databases in your workspace.
Read, search, and edit your Obsidian vault through the Local REST API community plugin.
Compare Todoist MCP (official, Doist) with: