MCP.so
Sign In

Todoist MCP Server

@miottid

About Todoist MCP Server

Augment LLMs with Todoist features

Basic information

Category

Productivity

License

MIT

Runtime

node

Transports

stdio

Publisher

miottid

Submitted by

David Miotti

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "todoist-mcp": {
      "command": "node",
      "args": [
        "/path/to/repo/build/index.js"
      ],
      "env": {
        "TODOIST_API_KEY": "your_todoist_api_key"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Todoist MCP Server?

Todoist MCP Server connects an LLM via the Model Context Protocol to Todoist, enabling task and project management through natural language commands. It provides access to all Todoist APIs via the official TypeScript client.

How to use Todoist MCP Server?

Build the server with npm install && npm run build, then configure a new MCP server in claude_desktop_config.json with the command node pointing to build/index.js and the TODOIST_API_TOKEN environment variable set to your Todoist API key. Launch the Claude desktop app and ask to update Todoist.

Key features of Todoist MCP Server

  • Create tasks with content, due dates, priorities, and labels
  • Create tasks using natural language (e.g., "Submit report by Friday 5pm #Work")
  • Retrieve, update, move, close, reopen, and delete tasks
  • Manage projects, sections, comments, and labels
  • View productivity statistics and project collaborators
  • Complete CRUD operations for all major Todoist entities

Use cases of Todoist MCP Server

  • Add tasks to Todoist directly from a conversation with an AI assistant
  • Organize projects and sections by giving natural language commands
  • Retrieve and review completed tasks or productivity stats without leaving the chat
  • Manage labels and comments collaboratively within a project
  • Automate routine Todoist updates via AI prompts

FAQ from Todoist MCP Server

What do I need to run Todoist MCP Server?

You need the Claude desktop app and a Todoist API token from Todoist Settings > Integrations > Developer.

How do I get a Todoist API token?

Go to Todoist > Settings > Integrations > Developer and generate an API token.

Which Todoist operations are supported?

All APIs from the Todoist TypeScript Client are available, including task, project, section, comment, label, and collaborator management.

Can I install Todoist MCP Server via Smithery?

Yes, you can install it on Claude Desktop using Smithery with npx -y @smithery/cli install @miottid/todoist-mcp --client claude.

Where does the server run?

It runs locally as a Node.js process on your machine, communicating with the Todoist API using your API token.

Comments

More Productivity MCP servers