Todoist MCP Server
Provides comprehensive task management capabilities including creating, listing, and completing tasks, as well as managing projects and labels through the Todoist API.
Click on "Deploy 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
Related MCP server: Todoist MCP Server
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 completenessThis server cannot be deployed
Maintenance
Related MCP Connectors
Create and manage MeisterTask projects, tasks, and notes from your AI assistant.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
- mcpOAuthnet.todoist
Official Todoist MCP server for AI assistants to manage tasks, projects, and workflows.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, labels, sections, and comments through natural conversation. Supports comprehensive task operations including creation, updates, completion, and organization with natural language quick-add functionality.-
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Todoist tasks and projects through natural language. Supports comprehensive task management including creating, updating, completing tasks, managing projects, and filtering by various criteria.11GPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, sections, and labels through natural language, supporting task creation, updates, completion, and intelligent organization of your workflow.9MIT
- AlicenseAqualityFmaintenanceEnables AI assistants to manage Todoist tasks, projects, and labels through natural language, with support for filters, priorities, and natural language dates.12MIT