Todoist MCP Server

What is Todoist MCP Server?

The Todoist MCP Server is a Model Context Protocol server that provides Todoist API integration for AI assistants, enabling them to manage tasks and projects on behalf of users.

How to use Todoist MCP Server?

Install Go 1.21 or later, set the TODOIST_API_TOKEN environment variable, then run the server in HTTP mode (go run cmd/todoist-mcp-server/main.go --mode http --addr :8080) or stdio mode (go run cmd/todoist-mcp-server/main.go --mode stdio). Integrate with MCP clients like Claude Desktop by adding the server configuration.

Key features of Todoist MCP Server

• Get tasks with filtering options
• Create new tasks with due dates and priorities
• Update existing tasks
• Mark tasks as completed
• Delete tasks
• Get all projects and project details

Use cases of Todoist MCP Server

• AI assistant manages a user's Todoist tasks via natural language
• Automatically create tasks with due strings, priorities, and project assignments
• View and update tasks from projects without switching apps
• Close or delete tasks as part of a workflow

FAQ from Todoist MCP Server

What prerequisites are required?

Go 1.21 or later and a Todoist API token must be available. The token can be set via the TODOIST_API_TOKEN environment variable or the --token flag.

How do I run the server in HTTP mode?

Use the command go run cmd/todoist-mcp-server/main.go --mode http --addr :8080 (or a different port). The server listens for HTTP requests on the specified address.

How do I integrate with Claude Desktop?

For stdio mode, add a configuration entry under mcpServers with the command path to the binary, args: ["--mode", "stdio"], and the TODOIST_API_TOKEN environment variable. For HTTP mode, configure a tool endpoint pointing to the running server.

What tools does the server expose?

It provides six task tools (todoist_get_tasks, todoist_get_task, todoist_create_task, todoist_update_task, todoist_close_task, todoist_delete_task) and two project tools (todoist_get_projects, todoist_get_project).

Can I download a pre-built binary instead of building from source?

Yes, pre-built binaries for Linux, macOS, and Windows are available on the GitHub Releases page. Extract the archive and optionally move the binary to a directory in your PATH.