A Model Context Protocol (MCP) server that provides Todoist API integration for AI assistants.
Todoist Go MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server that provides Todoist API integration for AI assistants.
The Todoist MCP Server allows AI assistants to interact with Todoist, enabling them to manage tasks and projects on behalf of users. This server implements the Model Context Protocol (MCP), providing a standardized interface for AI systems to access Todoist functionality.
Once Todoist Go is connected, these are the calls the assistant has available:
Prerequisites — The Prerequisites tool exposed by this serverSetup — Create a .envrc file in the root directory with the following content:todoist_get_task_filter_rules — Get filter rules and examples for Todoist task filters. This tool helps translate natural language queries into Todoist filter syntax for thetodoist_get_tasks — Parameters: - projectId (string, optional): Filter tasks by project ID - filter (string, optional): Todoist filter query using the Todoist filtertodoist_get_task — Parameters: - id (string, required): The unique identifier of the tasktodoist_create_task — Parameters: - content (string, required): The content of the task - description (string, optional): Detailed description or notes for the task -todoist_update_task — Parameters: - id (string, required): The unique identifier of the task to update - content (string, optional): The new content of the task -todoist_close_task — Parameters: - id (string, required): The unique identifier of the task to mark as completedtodoist_delete_task — Parameters: - id (string, required): The unique identifier of the task to deletetodoist_get_projects — The todoist_get_projects tool exposed by this servertodoist_get_project — Parameters: - id (string, required): The unique identifier of the projectConfiguration — Add the Todoist MCP Server to your Claude Desktop configuration:You will need 2 environment variables: TODOIST_API_TOKEN, YOUR_TODOIST_API_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.
This sits in the planning and project tracking group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Todoist Go's toolset — Prerequisites, Setup, todoist_get_task_filter_rules and 9 more — is a fair guide to whether it matches your workflow. It is maintained by naotama2002; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Todoist Go's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Prerequisites | The Prerequisites tool exposed by this server. |
| Setup | Create a .envrc file in the root directory with the following content: |
| todoist_get_task_filter_rules | Get filter rules and examples for Todoist task filters. This tool helps translate natural language queries into Todoist filter syntax for the todoist_get_tasks tool. |
| todoist_get_tasks | Parameters: - projectId (string, optional): Filter tasks by project ID - filter (string, optional): Todoist filter query using the Todoist filter syntax |
| todoist_get_task | Parameters: - id (string, required): The unique identifier of the task |
| todoist_create_task | Parameters: - content (string, required): The content of the task - description (string, optional): Detailed description or notes for the task - projectId (string, optional): Project ID to assign the task to - parentId ( |
| todoist_update_task | Parameters: - id (string, required): The unique identifier of the task to update - content (string, optional): The new content of the task - description (string, optional): Detailed description or notes for the task - pr |
| todoist_close_task | Parameters: - id (string, required): The unique identifier of the task to mark as completed |
| todoist_delete_task | Parameters: - id (string, required): The unique identifier of the task to delete |
| todoist_get_projects | The todoist_get_projects tool exposed by this server. |
| todoist_get_project | Parameters: - id (string, required): The unique identifier of the project |
| Configuration | Add the Todoist MCP Server to your Claude Desktop configuration: |
{
"mcpServers": {
"todoist": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"TODOIST_API_TOKEN=<YOUR_TODOIST_API_TOKEN>",
"ghcr.io/naotama2002/todoist-go-mcp-server:latest",
"--mode",
"stdio"
]
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| TODOIST_API_TOKEN | Credential the server authenticates with. | Yes |
| YOUR_TODOIST_API_TOKEN | Credential the server authenticates with. | Yes |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.