Grimoire

TickTick MCP — task-uri, habit-uri, focus blocks

3 min read

TickTick MCP — task-uri, habit-uri, focus blocks

TickTick e managerul principal de task-uri al operatorului. Wednesday îl atinge prin MCP via Claude.ai connector (claude_ai_Ticktick) — un MCP servit din partea Anthropic Claude.ai care vorbeşte cu API-ul oficial TickTick.

Toate cele 3 surface-uri (task-uri + habits + focus sessions) sunt acoperite. E unul din MCP-urile cele mai dense din ecosistem — 47 tool-uri exposed.

Ce face

OAuth complet cu TickTick API. Suportă citit + scris + organizare pe:

  • Task-uri — create/update/delete/complete, comments, due dates, priorities, tags, sub-tasks
  • Proiecte + groups — organizare ierarhică
  • Habit-uri — check-in zilnic, streak tracking, sections
  • Focus sessions — Pomodoro-ul TickTick, start/stop, statistici
  • Tag-uri + countdowns + columns (Kanban view)

Tool-uri exposed (cele importante)

Task-uri

  • create_task <project> <title> <due> <priority> — task nou
  • update_task <id> ... — modificare
  • complete_task <id> — bifare
  • delete_task <id>
  • batch_add_tasks / batch_update_tasks — pentru multe deodată
  • move_task <id> <new_project>
  • add_comment <task_id> <text> — comment pe task
  • search_task <query> — text search
  • filter_tasks <criteria> — filtru JSON (priority, tag, date, project)

Listing

  • list_undone_tasks_by_date <date> — ce e neîncheiat pe data X
  • list_undone_tasks_by_time_query <query> — “today”, “this_week”, “next_7_days”
  • list_completed_tasks_by_date <date> — ce ai bifat
  • get_project_with_undone_tasks <project_id> — content unui project

Proiecte + tags

  • list_projects / get_project_by_id
  • create_project / update_project / delete_project_group
  • list_tags / create_tag

Habits

  • list_habits — toate obiceiurile
  • get_habit <id> — detalii + check-in history
  • get_habit_checkins <habit_id> <range> — datele de check-in
  • upsert_habit_checkins — bulk update
  • complete_habit / fail_habit / skip_habit — single
  • complete_habits / fail_habits / skip_habits — bulk

Focus

  • create_focus <task_id?> <duration> — start Pomodoro
  • get_focus <id> / delete_focus
  • get_focuses_by_time <range> — sesiuni recente

Exemple de prompts

  • “Wednesday, ce am de făcut azi?” → list_undone_tasks_by_date date=2026-05-28
  • “Adaugă task: cumpără cadou aniversare Andrei, mâine, priority high” → create_task
  • “Bifează task-ul cu cumpărături” → search_task → complete_task
  • “Câte habits am completat săptămâna asta?” → get_habit_checkins × habits
  • “Generează raport săptămânal la habits” → skill habit-weekly-report (foloseşte MCP-ul intern)
  • “Start Pomodoro de 25 min pe task-ul X” → create_focus
  • “Mută task-ul ăsta din Inbox în ‘Nevermore Infra’” → move_task

Credenţiale

_infra/config/.credentials/ticktick.env — OAuth tokens (access_token + refresh_token, client_id + client_secret).

E un OAuth full (3-legged), expiră la ~6 luni dacă nu e folosit. Refresh-ul e automat când Wednesday vede 401.

MCP-ul rulează prin Claude.ai (connector remote), deci credenţialele sunt înmagazinate şi în Claude.ai’s connector store. Local file-ul e backup + folosit pentru alte runtime-uri (Hermes, Grok agent).

Skill-uri care folosesc TickTick

  • habit-weekly-report — generează raport săptămânal Markdown în _raw/reviews/Habits/
  • brain-dump — sparge un brain dump haotic în task-uri TickTick + proiecte + conexiuni
  • /track-price — adaugă watchlist task; nu folosește TickTick direct dar comuni cu cron similar
  • /remind — separate (daemon reminder-fire); TickTick are propriile remindere

Gotchas

  • MCP-ul ăsta vine via Claude.ai connector — nu e localhost. Dacă Claude.ai e down (rar), pierzi TickTick. Backup: aplicaţia TickTick direct.
  • create_task cu due date string e parse-uit relativ — “tomorrow 18:00” merge, dar timezone-ul e UTC default. Specifică timezone="Europe/Bucharest" dacă vezi shift.
  • Batch operations rate-limit — TickTick API limită ~10 req/sec. batch_add_tasks cu 50+ items poate eşua parţial. Wednesday face retry.
  • Habits NU sunt task-uri — sunt entitate separată. complete_habit ≠ complete_task. Confuziile sunt comune.
  • Focus sessions sunt 1:1 cu task-uri — un focus session e ataşat la un task (sau null pentru “general focus”). Statisticile per-task vin din asta.
  • OAuth refresh poate eşua silent dacă schimbi parola TickTick — re-auth interactiv pe developer.ticktick.com
  • Acelaşi MCP există în 2 versiuni: mcp__ticktick__* (Hermes local) şi mcp__claude_ai_Ticktick__* (Claude.ai connector). Wednesday alege automat pe baza disponibilităţii.

Graph View

Backlinks