Todoist MCP Server

# Todoist MCP Server MCP server for Todoist API with Nango authentication. ## Features - ✅ Works with `npx` without committing built files - ✅ Automatic build on installation - ✅ Nango OAuth authentication - ✅ Full Todoist API integration - ✅ Comprehensive task, project, and label management ## Quick Start ### Using npx (Recommended) ```bash npx -y git+https://github.com/ampcome-mcps/todoist-mcp.git ``` ### Using Docker ```bash docker build -t todoist-mcp . docker run -it --rm \ -e NANGO_CONNECTION_ID="your_connection_id" \ -e NANGO_INTEGRATION_ID="your_integration_id" \ -e NANGO_BASE_URL="https://api.nango.dev" \ -e NANGO_SECRET_KEY="your_secret_key" \ todoist-mcp ``` ### Local Development ```bash git clone https://github.com/ampcome-mcps/todoist-mcp.git cd todoist-mcp npm install npm run build npm start ``` ## Configuration Set these environment variables: ```bash NANGO_CONNECTION_ID=your_connection_id NANGO_INTEGRATION_ID=your_integration_id NANGO_BASE_URL=https://api.nango.dev NANGO_SECRET_KEY=your_secret_key ``` ## Claude Desktop Configuration ```json { "mcpServers": { "todoist": { "command": "npx", "args": ["-y", "git+https://github.com/ampcome-mcps/todoist-mcp.git"], "env": { "NANGO_CONNECTION_ID": "your_connection_id", "NANGO_INTEGRATION_ID": "your_integration_id", "NANGO_BASE_URL": "https://api.nango.dev", "NANGO_SECRET_KEY": "your_secret_key" } } } } ``` ## Available Tools - `listTasks` - List tasks with filters - `createTask` - Create new tasks - `completeTask` - Mark tasks as complete - `listProjects` - List all projects - `createProject` - Create new projects - `listLabels` - List all labels - `createLabel` - Create new labels ## Troubleshooting ### Build Issues If you encounter build issues: ```bash # Clear node_modules and reinstall rm -rf node_modules npm install # Manual build npm run build ``` ### Permission Issues If you get permission errors: ```bash # Make sure bin script is executable chmod +x bin/todoist-mcp.js # Or run directly with node node bin/todoist-mcp.js ``` ### Testing ```bash # Run various tests npm test # Basic functionality test npm run test:npx # Simulate npx installation npm run verify # Verify setup completeness ```