todoist

This MCP server exposes a set of tools that bridge Todoist data with AI assistants. It allows the assistant to list, create, update, and delete projects, sections, tasks, labels, and comments within your Todoist workspace. By running the server in Docker and providing your Todoist API token, you enable natural-language interactions that can manage your Todoist structure through prompts from an AI client.

To use the server, configure your MCP client to connect to the server and reference the available tools (e.g., get_projects, create_task, move_tasks_to_project, etc.). The tools support common Todoist operations such as fetching projects, creating sections, manipulating tasks, assigning labels, and commenting on items. Impressively, you can perform batch actions like moving multiple tasks between projects or sections or bulk updates to task properties, all through conversational commands.

Prerequisites:

• Docker installed on your machine (Docker Desktop for Windows/macOS or Docker Engine on Linux)
• A Todoist API token with appropriate permissions

Installation steps:

1. Ensure Docker is running on your system.
2. Create a practical run command by substituting your Todoist API token: docker run -i --rm -e TODOIST_API_TOKEN=your_token_here ghcr.io/koki-develop/todoist-mcp-server:latest
3. Alternatively, save the configuration for an MCP client using the provided mcp_config: { "mcpServers": { "todoist": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "TODOIST_API_TOKEN=<your_api_token_here>", "ghcr.io/koki-develop/todoist-mcp-server:latest" ] } } }
4. Verify connectivity by starting the server and connecting with your MCP client. Ensure the environment variable is set correctly and that the Todoist token has the required scopes.

Environment tips:

• Keep your Todoist API token secure; do not share the token in public configurations.
• If you rotate tokens, update the TODOIST_API_TOKEN value in your environment configuration.
• The server is containerized; you can pin a specific image tag for stability or use latest for updates.
• When using move or delete operations, be aware of potential data loss and confirm destructive actions in your prompts.
• If you encounter authentication errors, verify token permissions and that the token is active.
• For long-running tasks, consider using a robust MCP client to handle pagination and retries where supported by the client.

Configuration options:

• Todoist API token is provided via the TODOIST_API_TOKEN env var.
• The MCP client can be configured to pass additional Todoist-specific options if supported by the integration.