MCP (Model Context Protocol) server for TickTick task management
TickTick MCP has 14 well-named tools with consistent verb_noun patterns (get_, create_, update_, delete_). All tools have descriptions (avg ~80 chars, within baseline 34-392). Input schemas are present and properly typed with enums for constrained fields (priority, view_mode, kind). However, parameter descriptions are sparse or missing context. Output schemas are undocumented, LLMs cannot predict response structure. Error handling is absent; no recovery guidance or actionable error messages. No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels. Task formatting helpers exist but are internal; responses lack structured output guidance.
Create a new project in TickTick
Create a new task in TickTick
Create a new task with subtasks (checklist items)
Delete a project (WARNING: deletes all tasks in it!)
Get all unique tags used in tasks
Get tasks with high priority (🔴) or medium priority (🟡)
Get all tasks that are past their due date
No output schemas documented. LLMs cannot predict response structure (fields, types, pagination). Responses are formatted as text strings (format_task, format_tasks_list) rather than structured JSON. This forces LLMs to parse unstructured output, wasting tokens and increasing hallucination risk.
No error handling or recovery guidance. Tools lack try-catch blocks, validation, or actionable error messages. If API call fails, LLM receives raw exception or generic error with no guidance on retry, fallback, or next steps.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). delete_project is marked DESTRUCTIVE in metadata but tool definition lacks destructiveHint annotation. LLMs cannot infer safety implications from names alone.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | <=2025-11-25 | v2 |
Get a specific project by ID
Get project details along with all tasks and columns (for kanban)
Get all projects (lists) from TickTick
Get tasks from TickTick. Can filter by project or get all tasks.
Get tasks filtered by a specific tag
Get all tasks due today
Update an existing project
Parameter descriptions lack context and constraints. 'Project ID' and 'Tag name' are minimal. No guidance on format, length, or valid values. 'due_date' says 'YYYY-MM-DD format' but no validation or error message if LLM passes wrong format.
No pagination support. get_tasks, get_projects, get_all_tags return all results without limit or offset. Large result sets blow context window and degrade LLM reasoning. No documented result limits.