ticktick

TickTick

TickTick

Manage TickTick tasks and projects from chat -- create to-dos, organize projects, complete tasks, and track your productivity.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted OAuth flows and credentials so you don't need to configure TickTick API access yourself.

Setup in 3 Steps

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  TickTick API    │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

1. List your projects: ticktick_get_user_project -- see all your task lists and get project IDs.
2. Create a task: ticktick_create_task with a title and project ID to add a new to-do.
3. Complete a task: ticktick_complete_task with the project and task ID to mark it done.

Authentication

TickTick uses managed OAuth via ClawLink. No API keys needed. Connect your TickTick account at claw-link.dev/dashboard?add=ticktick and authorize access through the hosted flow.

Connection Management

List connections: clawlink_list_integrations -- confirm TickTick is connected.

Verify: Call ticktick_get_user_project to test access.

Reconnect: If you see auth errors, reconnect at claw-link.dev/dashboard?add=ticktick.

Security & Permissions

Read operations (list tasks, get projects) run safely without confirmation. Write operations (create, update, delete) require confirmation before executing. Delete operations are marked as high-impact and irreversible.

Tool Reference

Task Operations

Project Operations

OAuth Operations

Code Examples

List all projects and get tasks for one

{
  "tool": "ticktick_get_user_project"
}

{
  "tool": "ticktick_get_project_with_data",
  "args": { "project_id": "abc123" }
}

Create a task with a due date

{
  "tool": "ticktick_create_task",
  "args": {
    "title": "Review quarterly report",
    "project_id": "abc123",
    "due_date": "2026-06-15T09:00:00+0000",
    "priority": 3
  }
}

Complete a task

{
  "tool": "ticktick_complete_task",
  "args": {
    "project_id": "abc123",
    "task_id": "def456"
  }
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm ticktick is connected.
2. Call clawlink_list_tools --integration ticktick to see the live catalog.
3. Call ticktick_get_user_project to discover project IDs.
4. Use project IDs in task creation, updates, and retrieval.

Execution Workflow

Read Flow:  User asks for tasks  → clawlink resolves connection → TickTick API → results displayed
Write Flow: User wants to create  → confirmation prompt → clawlink resolves connection → TickTick API → result confirmed

Notes

• ticktick_get_project_with_data only returns incomplete tasks. Completed tasks are filtered by the API.
• Multiple tasks can share the same title; always use taskId for follow-up operations.
• TickTick's inbox project may not appear in get_user_project results. Omit projectId in create_task to target inbox.
• Updating a task cannot move it between projects. Use create + delete instead.
• Omitting optional fields in ticktick_update_task resets them to null.

Error Handling

Troubleshooting

Tools Not Visible

Run openclaw gateway restart after installing the plugin. Start a fresh chat session.

Invalid Tool Call

Check that the project ID and task ID are valid. Use ticktick_list_all_tasks or ticktick_get_user_project to discover IDs.

Resources

• TickTick API Docs: https://developer.ticktick.com/docs
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=ticktick
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw

ClawLink Logo