Todoist MCP Server (Python)
About
Manage your Todoist tasks and projects using the Todoist Python API.
Details
- Author
- mikemc
- GitHub stars
- 9
- Downloads
- 353
- Categories
- Productivity, Project Management
Jump to
- Full CRUD for projects, sections, tasks, and comments
- Filter and search tasks by criteria
- Complete and uncomplete tasks
- Move tasks between sections or projects
- Integrates with Claude Desktop and Goose (local LLM)
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
Install Python 3.10+, the UV package manager, and obtain a Todoist API token. Configure the server in claude_desktop_config.json using the uvx command with your token. Alternatively, configure it with Goose via goose configure and setting environment variables. Then invoke tools like todoist_get_tasks, todoist_add_task, etc.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"todoist mcp server (python)": {
"todoist": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/mikemc/todoist-mcp-server",
"todoist-mcp"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}
}McpServers
{
"todoist": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/mikemc/todoist-mcp-server",
"todoist-mcp"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}A Todoist MCP server written in Python, using theTodoist Python API. I first created the server by using Claude to translate thisTypeScript Todoist MCP serverto Python. I'm gradually changing and adding functionality to suit my workflow as I experiment with using Claude to help with task management.
- Python 3.10+
- UV package manager (installation guide)
- Todoist API token
- Log in to your Todoist account
- Go to Settings → Integrations
- Find your API token under "Developer"
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" } } } }
{ "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 useGooseand a local LLM provider:LM StudioorOllama.
Configure the LLM you want Goose to use:
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 withOllama, so for bothLM StudioorOllamaLLMs, selectOllama.
◇ 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:
◇ 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 rungooseand 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. ...
# With GNU grep installed as ggrep (as with brew install grep on Mac) ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' src/main.py
- Projects
- todoist_get_projects
- todoist_get_project
- todoist_add_project
- todoist_update_project
- todoist_delete_project
- todoist_get_sections
- todoist_get_section
- todoist_add_section
- todoist_update_section
- todoist_delete_section
- 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
- todoist_get_comment
- todoist_get_comments
- todoist_add_comment
- todoist_update_comment
- todoist_delete_comment
This project is licensed under the MIT License. See theLICENSEfile for details.
Interact with task, doc, and project data in Dart, an AI-native project management tool
Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp
The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.
Keep teams & agents coordinated automatically
From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
Official Taskeract MCP Server for integrating your Taskeract project tasks and load the context of your tasks into your MCP enabled app.
Manage your Todoist tasks and projects directly from your LLM.
Interact with Asana tasks, projects, workspaces, and comments using the Asana API.
Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment auto-download. Active fork of kocakli/Trello-Desktop-MCP integrating contributions from across the Trello MCP fork ecosystem
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
