MCP Todoist

What is MCP Todoist?

MCP Todoist is a Model Context Protocol (MCP) server that enables Claude to interact with your Todoist account. It allows task and project management through natural language commands.

How to use MCP Todoist?

Install via uvx mcp-todoist, set the TODOIST_API_TOKEN environment variable, and add the server to your Claude Desktop configuration. You can run the server from the command line, from source with UV, or via a startup script that launches automatically with Claude.

Key features of MCP Todoist

• Create, update, complete, and delete tasks
• Organize tasks in projects and with labels
• Search and filter tasks with complex criteria
• Seamless integration with Claude Desktop

Use cases of MCP Todoist

• Ask Claude to show tasks due today or this week
• Create new tasks or projects using natural language
• Mark tasks as complete or update existing tasks
• Search across all tasks with complex filters

FAQ from MCP Todoist

What are the prerequisites for MCP Todoist?

Python 3.11+, Astral UV, a Todoist account with an API token, and Claude Desktop.

How do I get my Todoist API token?

Obtain it from the Todoist Integrations settings page at https://app.todoist.com/app/settings/integrations/developer.

Can MCP Todoist be run without Claude Desktop?

The server itself can be started via command line, but it is designed for use with Claude Desktop as an MCP server.

How is the API token configured?

Set the TODOIST_API_TOKEN environment variable — either in your shell, in a .env file for local development, or inside a startup script used by Claude Desktop.

What should I do if the server is not available?

Ensure the server is running in a separate terminal or via a startup script, verify your API token is valid, and check that Astral UV is installed and in your PATH.