MCP server for integrating with Todoist task management API
18 tools with complete schemas and descriptions, but significant quality gaps. All tools have descriptions (10-200 chars, baseline 194), and input schemas are present with typed parameters. However, descriptions are generic and lack LLM-optimized guidance on WHEN to use each tool vs. similar ones. Parameter descriptions are minimal (e.g., 'ID of the task to update' without format/constraint details). No output schemas documented. Error handling is absent, no recovery guidance, no categorization of retryable vs. fatal errors. Missing tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). No pagination support on list tools (get_tasks, get_active_projects, get_labels, get_sections). update_project and update_task lack parameter details in source, update_project accepts only project_id with no update fields visible.
Create a new label in Todoist with options for name, color, order, and favorite status
Create a new project in Todoist with options for name, description, parent project, color, favorite status, and view style
Create a new section in a Todoist project
Create a new task in Todoist with comprehensive options for content, description, project, section, labels, priority, due dates, assignee, and duration
Mark a task as completed in Todoist
Delete a label from Todoist
update_project tool has incomplete schema, only project_id parameter visible in source, no update fields (name, description, color, etc.) documented. Violates pattern:tool requirement for complete parameter definitions.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields (e.g., task_id from add_task response). Violates pattern:tool and pattern:response-shaper.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | <=2025-11-25 | v2 |
Delete a project from Todoist
Delete a section from Todoist
Delete a task from Todoist
Retrieve all active projects from Todoist
Retrieve all labels from Todoist
Retrieve all sections for a specific project in Todoist
Retrieve tasks from Todoist with optional filtering by project, section, parent, label, or specific IDs
Reopen a completed task in Todoist
Update an existing label in Todoist
Update an existing project in Todoist
Update an existing section in Todoist
Update an existing task in Todoist with options to modify content, description, labels, priority, due dates, assignee, and other properties
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels declared (READ_ONLY, WRITE, DESTRUCTIVE). LLMs cannot infer safety properties without explicit hints.
List tools (get_tasks, get_active_projects, get_labels, get_sections) lack pagination support (limit/offset/cursor). Large result sets will blow context window. Violates pattern:paginated-result.
No error handling or recovery guidance. Tools return raw API responses without categorizing errors as retryable, user-fixable, or fatal. Violates pattern:recovery-guide and pattern:error-classification.