Provides comprehensive task management capabilities including creating, listing, and completing tasks, as well as managing projects and labels through the Todoist API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Todoist MCP Serveradd a task to buy groceries tomorrow at 5 PM"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.gitUsing 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-mcpLocal Development
git clone https://github.com/ampcome-mcps/todoist-mcp.git
cd todoist-mcp
npm install
npm run build
npm startConfiguration
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_keyClaude 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 buildPermission 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.jsTesting
# Run various tests
npm test # Basic functionality test
npm run test:npx # Simulate npx installation
npm run verify # Verify setup completeness