Todoist MCP Server

Todoist MCP Server (Python)

A Todoist MCP server written in Python, using the Todoist Python API. I first created the server by using Claude to translate this TypeScript Todoist MCP server to Python. I'm gradually changing and adding functionality to suit my workflow as I experiment with using Claude to help with task management.

Installation

Prerequisites

Python 3.10+
UV package manager (installation guide)
Todoist API token

Getting a Todoist API Token

Log in to your Todoist account
Go to Settings → Integrations
Find your API token under "Developer"

Configuration with Claude Desktop

Add the MCP server to your claude_desktop_config.json,

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mikemc/todoist-mcp-server",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

Or, to run from a local copy,

{
  "mcpServers": {
    "todoist": {
      "command": "uvx",
      "args": [
        "--from",
        "/absolute/path/to/todoist-mcp-server",
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_api_token"
      }
    }
  }
}

Configuration with Goose (and a local LLM)

You can use Goose and a local LLM provider: LM Studio or Ollama.

Configure the LLM you want Goose to use:

$ goose configure

This command will ask you whether you want to use a local model or a cloud hosted model. Ensure your model provider is running your model first. Specify the address of the model API, and the model name. Many locally deployed LLMs use a format compatible with Ollama, so for both LM Studio or Ollama LLMs, select Ollama.

◇  Which model provider should we use?
│  Ollama 
│
◇  Provider Ollama requires OLLAMA_HOST, please enter a value
│  localhost:1234
│
◇  Model fetch complete
│
◇  Enter a model from that provider:
│  phi-4

Then run the same command again to configure the Todoist MCP:

$ goose configure

This time it will ask about extensions:

◇  What would you like to configure?
│  Add Extension 
│
◇  What type of extension would you like to add?
│  Command-line Extension 
│
◇  What would you like to call this extension?
│  todoist
│
◇  What command should be run?
│  uvx git+https://github.com/mikemc/todoist-mcp-server
│
◇  Please set the timeout for this tool (in secs):
│  60
│
◇  Would you like to add a description?
│  No 
│
◇  Would you like to add environment variables?
│  Yes 
│
◇  Environment variable name:
│  TODOIST_API_TOKEN
│
◇  Environment variable value:
│  ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
│
◇  Add another environment variable?
│  No 
│
└  Added todoist extension

Now you can run goose and ask it questions about your todo list, or make changes.

$ goose          
starting session | provider: ollama model: phi-4
    logging to ******
    working directory: ******

Goose is running! Enter your instructions, or try asking what goose can do.

( O)> how many todo list tasks have I completed in the last 7 days

─── todoist_get_tasks | todoist ──────────────────────────
filter: last 7 days completed

...
*Ideally* You have been very busy this week. You have completed 15 tasks! Listed below are the tasks.
...

Available Tools

To see currently available tools, run

# With GNU grep installed as ggrep (as with `brew install grep` on Mac)
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' src/main.py

As of 2025-05-26,

Projects
- todoist_get_projects
- todoist_get_project
- todoist_add_project
- todoist_update_project
- todoist_delete_project
Sections
- todoist_get_sections
- todoist_get_section
- todoist_add_section
- todoist_update_section
- todoist_delete_section
Tasks
- todoist_get_task
- todoist_get_tasks
- todoist_filter_tasks
- todoist_add_task
- todoist_update_task
- todoist_complete_task
- todoist_uncomplete_task
- todoist_move_task
- todoist_delete_task
Comments
- todoist_get_comment
- todoist_get_comments
- todoist_add_comment
- todoist_update_comment
- todoist_delete_comment

License

This project is licensed under the MIT License. See the LICENSE file for details.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

A Python server that enables Claude to interact with Todoist's task management API, allowing users to create, manage, and organize tasks directly through Claude's interface.

Related MCP Servers

Todoist MCP Server
Chrusic
A
security
A
license
A
quality
Integrates Claude with Todoist for natural language task management, supporting project and section organization, task creation, updating, completion, and deletion using everyday language.
Last updated -
19
8
18
JavaScript
MIT License
Todoist MCP Server
abhiz123
A
security
A
license
A
quality
An MCP server that integrates Claude with Todoist, enabling natural language task management including creating, updating, completing, and deleting tasks.
Last updated -
5
1,117
297
JavaScript
MIT License
MCP Todoist
dkeesey
-
security
F
license
-
quality
A Model Context Protocol server that enables Claude to interact with your Todoist account, allowing you to manage tasks, projects, and labels through natural language.
Last updated -
1
Python
Todoist MCP Server
stevengonsalvez
-
security
A
license
-
quality
A Model Context Protocol server that enables advanced task and project management in Todoist via Claude Desktop and other MCP-compatible clients.
Last updated -
624
1
JavaScript
MIT License

View all related MCP servers

Todoist MCP Server