todoist -extended

This MCP server extends Claude (or any MCP-compatible LLM) with a Todoist integration, enabling natural language task management across tasks, projects, sections, and labels. The server exposes tools that let you create, update, complete, and delete tasks; manage projects, sections, and labels; perform smart searches and apply flexible filters; and execute batch operations for efficient LLM-driven workflows. Tools are designed to be invoked from Claude’s MCP interface, so you can issue natural language commands like creating a task in a project’s section, adding labels, or listing tasks that match certain criteria. The setup supports Claude Desktop via the included MVP configuration and is also usable with other MCP-compatible LLMs that can call the provided tools.

Prerequisites:

• Node.js and npm installed on your machine (or access to a host where npx is available).
• Todoist API token to authorize access to your Todoist account.

Installation via Smithery:

1. Open your terminal and run:

npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude

Note: You can replace --client claude with --client cline or --client windsurf if you use alternative clients.

Installation via npm:

1. Run:

npm install -g @chrusic/todoist-mcp-server-extended

Configuration (example for Claude Desktop):
1. In Claude Desktop, edit claude_desktop_config.json to add the MCP server under mcpServers using the following structure (insert your token in place of the placeholder):

```json
"mcpServers": {
  "todoist": {
    "command": "npx",
    "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
    "env": {
      "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE"
    }
  }
}

2. Save the file and restart Claude Desktop to load the MCP server and its tools.

Tips and common issues:

• Ensure you have a valid Todoist API token and grant the necessary permissions for your tasks, projects, sections, and labels.
• The MCP server relies on the Todoist API; respect rate limits and handle authentication securely (avoid exposing your token in logs or shared configs).
• If you encounter connectivity or token errors, double-check the token scope, and verify that the environment variable is correctly loaded by the client you’re using.
• The npm package name is @chrusic/todoist-mcp-server-extended; you can pin a specific version if needed by adjusting the install command.
• For Claude Desktop users, tools are exposed with names like todoist_get_tasks, todoist_create_task, etc., and you can perform batch operations to optimize LLM workflows. See doc/tools.md in the repository for a complete list of tools and usage syntax.