How do I install the todoist go mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

The recorded environment keys are `TODOIST_API_TOKEN`. Keep credentials outside committed files and confirm the configuration required by your installed version.

SSyncDev

Start a project

Todoist Go MCP Server

A Model Context Protocol (MCP) server that provides Todoist API integration for AI assistants.

Local serverstdioGo

What is the Todoist Go MCP Server?

A Model Context Protocol (MCP) server that provides Todoist API integration for AI assistants.

What you get

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.

Task Management —
Get filter rules and examples for task filtering
Get tasks with filtering options
Get task details
Create new tasks
Update existing tasks

Configuration and credentials

Go 1.21 or later (for building from source) - Docker (for Docker installation) - Todoist API token

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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
todoist_get_project	Parameters: - id (string, required): The unique identifier of the project

How to install the Todoist Go MCP Server

{
  "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.

Configuration

Go 1.21 or later (for building from source) - Docker (for Docker installation) - Todoist API token

Variable	Description	Required
TODOIST_API_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use Todoist Go to Prerequisites.”
“Use Todoist Go to Setup.”
“Use Todoist Go to todoist get task filter rules.”

Frequently asked questions

A Model Context Protocol (MCP) server that provides Todoist API integration for AI assistants. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.