Todoist MCP サーバー

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

Claude が Todoist のタスク管理 API と対話できるようにする Python サーバー。これにより、ユーザーは Claude のインターフェースを通じて直接タスクを作成、管理、整理できるようになります。

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

Todoist MCP Server (Python)

Installation

Prerequisites

Getting a Todoist API Token

Configuration with Claude Desktop

Configuration with Goose (and a local LLM)

Available Tools

License

Tools

Related MCP Servers

Todoist MCP Server

Todoist MCP Server

MCP Todoist

Todoist MCP Server

Appeared in Searches

MCP directory API