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.