ticktick_sync
Force an immediate refresh of TickTick state from the server to get up-to-date task and project data, preventing stale reads after external changes.
Instructions
Force an immediate refresh of TickTick state from the server.
The active-read tools (ticktick_get_by_id,
ticktick_get_tasks_from_project, ticktick_filter_tasks) already
auto-refresh at most once per throttle window (default 15s, overridable
via TICKTICK_MCP_SYNC_TTL_SECONDS). Call this when you need an
immediate refresh -- e.g. you just changed something in the TickTick app
on another device, or a read looks stale and you want to be certain
before acting.
Returns:
{"status": "synced", "task_count": N, "project_count": M} on
success. {"status": "error", "detail": "..."} if the refresh
failed -- the previous (stale) state is still served by the read
tools, so callers can continue with reduced confidence.
Example: ticktick_sync()
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |