ticktick_get_tasks_from_project
Fetches all open tasks from a specified TickTick project using its ID or name. Supports compact or full output for efficient browsing or updating.
Instructions
Return every open task in a project.
Args:
project_id (str): The project's ID or name. Accepts the project's name as well as its ID
(case-insensitive, trimmed; "Inbox" resolves to the inbox).
Two projects sharing a name is an error, not a guess.
List them with ticktick_get_all(search="projects").
detail (str, optional): "compact" (default) or "full".
Compact drops the heavy content/desc/checklist
items blobs and bulky sync metadata, keeping id,
projectId, title, dueDate, startDate, priority, status,
isAllDay, timeZone, tags plus a contentPreview (first
~200 chars of content) so keyword search still works. Full
returns the raw task objects unchanged.
Returns:
Compact (default): JSON list of compact task objects. If the
compact payload would still exceed the size budget, the
soonest-due tasks are returned and a final _truncation_note
element reports how many were omitted -- nothing is dropped
silently.
Full: JSON list of raw task objects (empty list if none).
On failure: {"error": "...", "status": "error"}.
Limitations:
- Completed tasks are NOT included.
- Compact output is for browsing only. To EDIT a task, fetch the
full object with ticktick_get_by_id first, then send every
field back via ticktick_update_task (the API wipes any
field omitted from an update). Get the full content of a single
task with ticktick_get_by_id, or pass detail="full".
Freshness:
Local state is synced from the server at most once per throttle
window (default 15s, TICKTICK_MCP_SYNC_TTL_SECONDS); an edit made
elsewhere within that window may not be visible yet. Call
ticktick_sync to force an immediate refresh.
Example: ticktick_get_tasks_from_project( project_id="" )
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| detail | No | compact | |
| project_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |