Todoist MCP Server (community, abhiz123)

Lightweight community Todoist server for natural-language task create, update, and search.

Verified

stdio (local)

API key

Stale

TypeScript

View repo 393 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npx -y @abhiz123/todoist-mcp-server

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "todoist-mcp-server-community-abhiz123": {
      "command": "npx",
      "args": [
        "-y",
        "@abhiz123/todoist-mcp-server"
      ],
      "env": {
        "TODOIST_API_TOKEN": "<your-todoist-api-token>"
      }
    }
  }
}

Before you start

Node.js installed (used to run via npx / global install)
A Todoist account
A Todoist API token from Todoist → Settings → Integrations → Developer, set as the TODOIST_API_TOKEN environment variable

About Todoist MCP Server (community, abhiz123)

A lightweight, community-built MCP server that connects Claude (and other MCP clients) to Todoist for natural-language task management. It focuses on the essentials: create, read, update, complete, and delete tasks through everyday language.

Its standout feature is natural-language task targeting — you don't need task IDs. You can say "mark the PR review task as complete" or "change priority of the bug fix task to urgent," and the server resolves the task by partial name match. Task retrieval supports filtering by due date, priority, and project, including natural-language date phrases like "due this week."

It runs over stdio and authenticates with a single Todoist API token (TODOIST_API_TOKEN). Installation is a one-liner via npm or Smithery, making it a good pick when you want quick conversational task control without the broader surface of the official server.

Tools & capabilities (5)

todoist_create_task

Create a task with content and optional description, due date (natural language), and priority (1-4).

todoist_get_tasks

Retrieve and filter tasks by due date, priority, or project, with optional result limits.

todoist_update_task

Update a task's content, description, due date, or priority, locating it by natural-language name search.

todoist_complete_task

Mark a task complete, located by natural-language partial-name match.

todoist_delete_task

Delete a task, located by natural-language partial-name match.

When to use it

Use it when you want simple, conversational task control in Claude without managing task IDs.
Use it when you need a minimal, fast-to-install Todoist server rather than a full API wrapper.
Use it when you want to filter or list tasks with phrases like "show tasks due this week."
Use it when you want to create tasks with priority and due dates from a single natural-language prompt.
Use it when you're prototyping an agent and want the lowest-friction Todoist integration.

Quick setup

1Get a Todoist API token from Settings → Integrations → Developer.
2Install via Smithery (npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude) or globally (npm install -g @abhiz123/todoist-mcp-server).
3Add it to claude_desktop_config.json with command `npx`, args `-y @abhiz123/todoist-mcp-server`, and env TODOIST_API_TOKEN.
4Restart Claude Desktop (or your MCP client).
5Verify by asking Claude to create or list a Todoist task.

Security notes

The TODOIST_API_TOKEN has full access to your Todoist account, so keep it in env vars only. This is a community project that is less actively maintained than Doist's official server.

Todoist MCP Server (community, abhiz123) FAQ

How do I authenticate?

Set the TODOIST_API_TOKEN environment variable to a token from Todoist Settings → Integrations → Developer. There is no OAuth flow.

Do I need to know task IDs to update or complete tasks?

No. The update, complete, and delete tools find tasks by partial-name (natural-language) match, so you can refer to tasks by description.

Is this the official Todoist server?

No — it's a community project by abhiz123. Doist publishes the official one under the @doist scope.

What can it manage?

It covers task create, read, update, complete, and delete. It does not expose dedicated tools for projects, sections, or labels.

Is it free?

Yes, it's open source under the MIT license and free to use; you only need a Todoist account and API token.

#todoist #tasks #to-do #community

Alternatives to Todoist MCP Server (community, abhiz123)

mcp-atlassian (community Jira/Confluence)

Productivity

5.4k

Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.

Verified

stdio (local)

API key

Python

11 tools

Updated 2 months agoRepo

Notion MCP Server (official)

Productivity

3.9k

Official Notion server to read, search, create, and update pages and databases in your workspace.

Verified

stdio (local)

API key

TypeScript

9 tools

Updated 4 months agoRepo

mcp-obsidian (Obsidian Local REST API)

Productivity

3.6k

Read, search, and edit your Obsidian vault through the Local REST API community plugin.

Verified

stdio (local)

API key

Python

7 tools

Updated 4 months agoRepo

Compare Todoist MCP Server (community, abhiz123) with:

vs mcp-atlassian (community Jira/Confluence)vs Notion MCP Server (official)vs mcp-obsidian (Obsidian Local REST API)vs Linear MCP Server (official remote)