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)

npx -y git+https://github.com/ampcome-mcps/todoist-mcp.git

Using Docker

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

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:

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

{
  "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:

# Clear node_modules and reinstall
rm -rf node_modules
npm install

# Manual build
npm run build

Permission Issues

If you get permission errors:

# Make sure bin script is executable
chmod +x bin/todoist-mcp.js

# Or run directly with node
node bin/todoist-mcp.js

Testing

# Run various tests
npm test              # Basic functionality test
npm run test:npx      # Simulate npx installation
npm run verify        # Verify setup completeness