ticktick_get_tasks_from_project
Retrieve all open tasks from a TickTick project. Use compact detail for quick browsing with key fields and a content preview, or full detail for complete task data.
Instructions
Return every open task in a project.
Args:
project_id (str): The project's ID. For the inbox, pass the
value of client.inbox_id (look it up via
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 |
|---|---|---|---|
| project_id | Yes | ||
| detail | No | compact |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |