Todoist MCP Server
MCP ServerFreeCreate and manage Todoist tasks and projects via MCP.
Capabilities12 decomposed
natural language task creation with semantic parameter parsing
Medium confidenceTranslates conversational task descriptions into structured Todoist API calls by parsing natural language for task content, due dates (e.g., 'tomorrow', 'next Monday'), priority levels (1-4 semantic mapping), and optional descriptions. Uses date recognition to convert human-readable temporal references into ISO format and priority mapping to interpret semantic priority language, then submits via Todoist REST API with full parameter validation.
Implements semantic date and priority parsing within the MCP tool handler itself, converting natural language directly to Todoist API parameters without requiring a separate NLP service or external date parsing library, reducing latency and external dependencies
Faster than generic task creation APIs because date/priority parsing is embedded in the MCP handler rather than requiring round-trip calls to external NLP services or Claude for parameter extraction
filtered task retrieval with natural language query translation
Medium confidenceQueries Todoist tasks using natural language filters (e.g., 'overdue tasks', 'tasks due this week', 'high priority tasks') by translating conversational filter expressions into Todoist API filter syntax. Supports partial name matching for task identification, date range filtering, priority filtering, and result limiting. Implements filter translation logic that converts semantic language into Todoist's native query parameter format before executing REST API calls.
Translates natural language filter expressions (e.g., 'overdue', 'this week') directly into Todoist API filter parameters within the MCP handler, avoiding the need for Claude to construct API syntax or make multiple round-trip calls to clarify filter intent
More efficient than generic task APIs because filter translation is built into the MCP tool, reducing latency compared to systems that require Claude to generate filter syntax or make separate API calls to validate filter parameters
project and label management through todoist api
Medium confidenceManages task organization by supporting project assignment and label association through Todoist API integration. Enables users to specify project_id when creating or updating tasks, and supports label assignment through task parameters. Implements project and label lookups to translate project/label names into IDs required by Todoist API, supporting task organization without requiring users to know numeric project IDs.
Integrates project and label management into task creation/update tools, allowing users to organize tasks by project and label without separate API calls, reducing friction in conversational task management
More convenient than direct API project assignment because it supports project name lookup in addition to IDs, making it suitable for conversational interfaces where users reference projects by name
executable cli binary with npm package distribution
Medium confidencePackages the Todoist MCP server as an executable CLI binary (todoist-mcp-server) distributed via npm, enabling one-command installation and execution. Implements build process using TypeScript compilation (tsc) with executable permissions set via shx chmod +x, generating dist/index.js as the main entry point. Supports installation via npm install or Smithery package manager, with automatic binary availability in PATH after installation.
Distributes MCP server as an npm package with executable binary, enabling one-command installation and integration with Claude Desktop without manual configuration or build steps
More accessible than manual installation because users can install with npm install @smithery/todoist-mcp-server, reducing setup friction compared to cloning repositories and building from source
task attribute modification with name-based task identification
Medium confidenceUpdates task attributes (name, description, due date, priority, project) by first identifying the target task using partial name matching against the task list, then applying the requested modifications via Todoist REST API. Implements a two-step process: (1) search for task by name fragment, (2) update matched task with new attribute values. Supports atomic updates of individual attributes without requiring full task replacement.
Implements client-side task identification via partial name matching before API update, allowing users to reference tasks by incomplete descriptions without requiring exact task IDs, reducing friction in conversational workflows
More user-friendly than direct API updates because it accepts partial task names instead of requiring task IDs, making it suitable for conversational interfaces where users describe tasks naturally rather than providing identifiers
task completion with partial name matching and status confirmation
Medium confidenceMarks tasks as complete by identifying the target task using partial name matching, then submitting a completion request to the Todoist API. Implements name-based task lookup followed by a completion API call, with optional status confirmation returned to the user. Supports completing tasks without requiring exact task IDs or manual task selection.
Combines task identification (partial name matching) with completion in a single MCP tool call, eliminating the need for separate lookup and completion steps, reducing round-trips in conversational task management workflows
More efficient than generic task completion APIs because it integrates name-based task lookup, reducing the number of API calls and user interactions required to complete a task from a conversational description
task deletion with name-based identification and deletion confirmation
Medium confidenceRemoves tasks from Todoist by identifying the target task using partial name matching, then submitting a deletion request to the Todoist API. Implements name-based task lookup followed by a delete API call, with confirmation returned to the user. Supports task removal without requiring exact task IDs, making deletion accessible through conversational interfaces.
Integrates name-based task identification with deletion in a single MCP tool call, allowing users to delete tasks by conversational description rather than task ID, reducing friction in task cleanup workflows
More accessible than direct API deletion because it accepts partial task names instead of requiring task IDs, making it suitable for conversational interfaces where users describe tasks naturally
mcp protocol bridging with stdio transport and schema-based tool registration
Medium confidenceImplements the Model Context Protocol (MCP) server using stdio transport to enable bidirectional communication between Claude Desktop and the Todoist MCP server. Uses schema-based tool registration (CallToolRequestSchema) to define and validate tool parameters, with StdioServerTransport handling message serialization and deserialization. Implements the MCP server lifecycle (initialization, tool discovery, request handling) with proper error handling and type safety through TypeScript.
Implements MCP server with stdio transport and schema-based tool registration, providing a lightweight protocol bridge that requires no external dependencies beyond Node.js and the Todoist API, enabling direct Claude-to-Todoist integration without cloud intermediaries
More lightweight than REST API wrappers because it uses stdio transport (no HTTP overhead) and integrates directly with Claude's MCP protocol, reducing latency and eliminating the need for separate API gateway infrastructure
type-safe parameter validation with typescript schema enforcement
Medium confidenceEnforces type safety and parameter validation across all MCP tools using TypeScript type definitions and schema validation. Implements CallToolRequestSchema to define expected parameters for each tool (content, due_date, priority, project_id, etc.), with runtime validation before tool execution. Validates input types, required fields, and parameter ranges (e.g., priority 1-4) to prevent invalid API calls to Todoist.
Implements schema-based parameter validation at the MCP protocol layer using TypeScript type definitions, catching invalid parameters before they reach the Todoist API and preventing malformed requests from being submitted
More robust than runtime-only validation because it combines TypeScript compile-time type checking with MCP schema validation, catching errors at multiple layers and providing clear error messages to Claude
todoist rest api integration with authentication and error handling
Medium confidenceIntegrates with Todoist's REST API by managing authentication (API token in Authorization header), constructing API requests for each tool operation, and handling API responses and errors. Implements HTTP client logic to submit requests to Todoist endpoints (create task, get tasks, update task, complete task, delete task) with proper error handling for rate limits, authentication failures, and invalid requests. Translates Todoist API responses into MCP tool results.
Implements Todoist API integration directly in the MCP server without external HTTP client libraries, using Node.js built-in fetch API to minimize dependencies and reduce deployment complexity
Simpler than wrapper libraries because it implements API calls directly in the MCP handler, reducing external dependencies and making it easier to customize error handling and request formatting for MCP-specific requirements
date parsing and normalization for natural language temporal references
Medium confidenceConverts natural language date expressions (e.g., 'tomorrow', 'next Monday', 'this week', 'in 3 days') into ISO 8601 format required by Todoist API. Implements pattern matching for common temporal phrases and calculates relative dates based on the current date. Supports both relative dates (today, tomorrow, next week) and absolute references (specific day names), normalizing all inputs to ISO format before API submission.
Implements date parsing directly in the MCP tool handler using pattern matching and relative date calculations, avoiding external date libraries and enabling lightweight date normalization without additional dependencies
More efficient than calling Claude for date parsing because date conversion is handled locally in the MCP handler, reducing round-trips and latency for common temporal expressions
priority level semantic mapping and translation
Medium confidenceTranslates semantic priority language (e.g., 'high', 'low', 'urgent', 'normal') into Todoist's numeric priority scale (1-4, where 4 is highest). Implements a mapping table that converts natural language priority expressions into the corresponding numeric values required by Todoist API. Supports both explicit numeric priorities and semantic language, normalizing all inputs to Todoist's numeric format.
Implements priority mapping as a simple lookup table in the MCP tool handler, enabling semantic priority language without external NLP services or Claude round-trips, reducing latency and dependencies
More efficient than asking Claude to translate priority language because mapping is handled locally in the MCP handler, reducing round-trips and ensuring consistent priority mapping across all tool invocations
Capabilities are decomposed by AI analysis. Each maps to specific user intents and improves with match feedback.
Related Artifactssharing capabilities
Artifacts that share capabilities with Todoist MCP Server, ranked by overlap. Discovered automatically through the match graph.
Todo.is
Transform tasks with AI-driven management and...
Bottr
Revolutionize task management and engagement with an adaptable, AI-powered...
Taskade
Build, train, and deploy autonomous AI agents for task management, team collaboration, and workflow automation—all within a unified...
Assisterr
Boost productivity with AI: task management, data insights, customizable, integrates...
Jife
Maximize productivity with AI-driven automation, analytics, and project...
Antispace
AI-driven tool automates emails, calendars, notes, Slack,...
Best For
- ✓Claude Desktop users managing tasks through conversational AI
- ✓Teams automating task creation from natural language prompts in AI workflows
- ✓Non-technical users who prefer speaking task requirements naturally rather than using structured forms
- ✓Claude Desktop users querying their task list conversationally
- ✓AI agents that need to filter tasks before taking actions (e.g., completing overdue items)
- ✓Teams building task-aware workflows that require dynamic task filtering based on user input
- ✓Claude Desktop users organizing tasks across multiple projects
- ✓Teams using Todoist projects for workflow organization
Known Limitations
- ⚠Date parsing relies on predefined natural language patterns; ambiguous dates (e.g., '3/4') may not resolve correctly
- ⚠Priority mapping is fixed to Todoist's 1-4 scale; custom priority systems are not supported
- ⚠No support for recurring task patterns or complex scheduling logic beyond single due dates
- ⚠Task creation is synchronous; bulk creation of 100+ tasks may experience latency
- ⚠Filter translation supports only predefined natural language patterns; complex boolean logic (AND/OR combinations) is not supported
- ⚠Partial name matching is case-insensitive but does not support regex patterns or fuzzy matching
Requirements
Input / Output
UnfragileRank
UnfragileRank is computed from adoption signals, documentation quality, ecosystem connectivity, match graph feedback, and freshness. No artifact can pay for a higher rank.
About
Community MCP server for Todoist task management. Provides tools to create, update, complete, and delete tasks, manage projects and labels, and query tasks by filters and due dates.
Categories
Alternatives to Todoist MCP Server
Are you the builder of Todoist MCP Server?
Claim this artifact to get a verified badge, access match analytics, see which intents users search for, and manage your listing.
Get the weekly brief
New tools, rising stars, and what's actually worth your time. No spam.
Data Sources
Looking for something else?
Search →