Todoist MCP Server (Python)
About
The Todoist MCP Server (Python) is a server that integrates Todoist with the Model Context Protocol (MCP), enabling AI assistants like Claude to interact with Todoist tasks and projects. It is a Python port of an existing TypeScript version, using the Python MCP SDK and Todoist…
Explore
- Integrates Todoist with MCP‑compatible clients
- Leverages Python MCP SDK and Todoist Python API
- Provides tools for task and project management
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Todoist MCP Server (Python)Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Python 3.10+
UV package manager (installation guide)
- Todoist API token
1. Log in to your Todoist account
2. Go to Settings → Integrations
3. Find your API token under "Developer"
Add to your claude_desktop_config.json:
{
"mcpServers": {
"todoist": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/todoist-mcp-server",
"run",
"main.py"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' main.py
```
To see currently available tools,
```sh
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"todoist mcp server (python)": {
"todoist": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/todoist-mcp-server",
"run",
"main.py"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}
}McpServers
{
"todoist": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/todoist-mcp-server",
"run",
"main.py"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}This is a Python port of this TypeScript Todoist MCP server. The port was created with Claude to provide the same functionality while leveraging the Python MCP SDK and Todoist Python API.
Installation
Prerequisites
Python 3.10+
UV package manager (installation guide)
- Todoist API token
Getting a Todoist API Token
1. Log in to your Todoist account
2. Go to Settings → Integrations
3. Find your API token under "Developer"
Configuration with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"todoist": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/todoist-mcp-server",
"run",
"main.py"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}
Available Tools
To see currently available tools,
```sh
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
