pm-ticktick

pm-ticktick

Purpose

Reads projects and project tasks, and writes task create/complete/delete actions, through the TickTick Open API.

Icon

• id: simple-icons-ticktick
• asset: icons/simple-icons/ticktick.svg
• title: TickTick
• simple_icon_slug: ticktick
• simple_icon_hex: 4772FA
• source: simple-icons
• license: CC0-1.0
• review_status: cc0_with_trademark_caveat
• review_url: https://simpleicons.org/?q=TickTick
• match: exact-name-or-slug
• matched_by: ticktick

Capabilities

• check=true catalog=true read=true write=true query=false
• Integration type: api

Authentication

• Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

• base_url
• project_id
• access_token (secret)
• bearer_token (secret)
• client_access_token (secret)

ETL Streams

• projects:
  • primary key: id
  • fields: closed(string), color(string), groupId(string), id(string), kind(string), name(string), permission(string), sortOrder(integer), viewMode(string)
• tasks:
  • primary key: id
  • fields: completedTime(string), content(string), desc(string), dueDate(string), id(string), isAllDay(string), modifiedTime(string), priority(integer), projectId(string), reminders(array), repeatFlag(string), sortOrder(integer), startDate(string), status(integer), timeZone(string), title(string)

Sync Modes

• ETL sync modes: full_refresh_append, full_refresh_overwrite

Reverse ETL Actions

• create_task:
  • endpoint: POST /task
  • required fields: title
  • risk: creates a new task in the caller's TickTick account (in the given projectId, or the default Inbox if omitted); low-risk external mutation, no approval required
• complete_task:
  • endpoint: POST /project/{{ record.projectId }}/task/{{ record.id }}/complete
  • required fields: projectId, id
  • risk: marks an existing task as completed; a completed task is removed from active task lists/reminders for every collaborator on the project
• delete_task:
  • endpoint: DELETE /project/{{ record.projectId }}/task/{{ record.id }}
  • required fields: projectId, id
  • risk: permanently removes a task from the given project; irreversible, no undo via the API

Security

• read risk: external TickTick API read of project and task data
• write risk: external TickTick API mutation: creates a task, marks a task complete, or permanently deletes a task
• approval: reverse ETL plan approval required before writes
• Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect ticktick

Inspect as structured JSON

pm connectors inspect ticktick --json

Agent Rules

• Run pm connectors inspect ticktick before creating credentials or plans.
• Use --json only when the caller needs structured output; use the manual for human-readable guidance.
• Never ask the user to paste secret values into chat.
• For reverse ETL writes, create a plan, show the preview, wait for explicit approval, then run with the approval token.