Provides comprehensive task management capabilities including creating, listing, and completing tasks, as well as managing projects and labels through the Todoist API.
Todoist MCP Server
MCP server for Todoist API with Nango authentication.
Features
✅ Works with
npxwithout 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 filterscreateTask- Create new taskscompleteTask- Mark tasks as completelistProjects- List all projectscreateProject- Create new projectslistLabels- List all labelscreateLabel- 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