Overview
What is Todoist MCP Server (Python)?
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 Python API.
How to use Todoist MCP Server (Python)?
Install Python 3.10+ and UV package manager, obtain a Todoist API token from your account settings (Settings → Integrations → Developer), then configure your MCP client (e.g., Claude Desktop) by adding the server entry to claude_desktop_config.json with the absolute path to the server directory and the token as an environment variable.
Key features of Todoist MCP Server (Python)
- Integrates Todoist with MCP‑compatible clients
- Leverages Python MCP SDK and Todoist Python API
- Provides tools for task and project management
Use cases of Todoist MCP Server (Python)
- Using AI assistants to create, read, update, or delete Todoist tasks
- Managing Todoist projects and tasks via natural language commands in an MCP client
FAQ from Todoist MCP Server (Python)
What is the difference between this and the TypeScript server?
This server is a Python port of the TypeScript Todoist MCP server, providing the same functionality while using the Python MCP SDK and Todoist Python API.
What are the runtime requirements?
Python 3.10 or higher, the UV package manager, and a valid Todoist API token.
Where does my data live?
The server interacts with Todoist’s cloud API; tasks and projects data remain on Todoist’s servers, accessed via the API token provided in configuration.
What transport does it use?
The server uses the standard MCP transport, communicating over stdin/stdout as configured in the MCP client.
How is authentication handled?
Authentication is done via a Todoist API token, which must be set as the TODOIST_API_TOKEN environment variable in the client configuration.
