Todoist MCP Server

A TypeScript-based Model Context Protocol (MCP) server that provides Todoist task management capabilities to AI assistants. This MCP server is built for use with Claude Desktop and operates over stdio.

Note: This MCP server is tailored to my specific workflow with Todoist and may not align with how others use the tool.

Getting Started

Prerequisites

• Node.js 18+

• Todoist account with API access

Install

git clone <repository-url>
cd todoist-mcp
npm ci

Configure

cp env.example .env
# Add your Todoist API token to .env

Connect to Claude Desktop

1. Configure Claude Desktop

Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Add MCP Server Configuration

{
  "mcpServers": {
    "todoist": {
      "command": "$PATH_TO_REPO/start-mcp.sh",
      "args": [],
      "env": {}
    }
  }
}

Replace $PATH_TO_REPO with the absolute path of where you cloned this repo.

3. Restart Claude Desktop

Restart Claude Desktop completely for the changes to take effect.

4. Verify Connection

Test the connection by asking Claude to list your Todoist projects or tasks.