Advertise
MCP.so
Sign In

Tick Tick MCP Server

@Salen-Project

RepositoryHomepage

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

Salen-Project

Submitted by

ABDULHAMID NURIDDINOV

About Tick Tick MCP Server

Turn Claude into your AI task manager. Create, manage & complete TickTick tasks just by talking — official OAuth API, local, private.

Tick Tick MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ticktick": {
      "type": "stdio",
      "command": "python3",
      "args": [
        "server.py"
      ],
      "env": {
        "TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "TICKTICK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Tick Tick MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Tick Tick Mcp?

Tick Tick Mcp connects Claude to your TickTick account, allowing you to manage your entire task system through natural conversation. It provides 28 tools for full CRUD operations, smart queries, multi-condition filters, batch operations, and GTD support.

How to use Tick Tick Mcp?

Clone the repository, install dependencies, run TICKTICK_CLIENT_ID=your_id TICKTICK_CLIENT_SECRET=your_secret .venv/bin/python3 setup_auth.py to authenticate via OAuth, then register with Claude Code using claude mcp add ticktick or by editing claude_desktop_config.json.

Key features of Tick Tick Mcp

  • 28 tools covering projects, tasks, subtasks, and user preferences
  • Full CRUD and batch operations (up to 20 tasks at once)
  • Multi-condition filters (priority + tag + date + project + status)
  • GTD focus view: high priority + due today + overdue tasks
  • Dida365 (Chinese TickTick) support via configurable base URL
  • Async httpx, Pydantic input validation, and MCP annotations

Use cases of Tick Tick Mcp

  • Create tasks with due dates, priorities, and projects via natural language
  • Search across all projects, check overdue or due-this-week tasks
  • Batch create, update, or complete multiple tasks in one command
  • Create and manage projects, subtasks, and move tasks between projects
  • View completed tasks, user preferences, and GTD-focused task lists

Frequently asked questions

1

What are the prerequisites for Tick Tick Mcp?

A TickTick account, Python 3.10+, and either Claude Code or Claude Desktop are required.

2

How do I authenticate Tick Tick Mcp?

You must register a developer app on developer.ticktick.com with OAuth redirect URL `http://localhost:8080/callback`, then run `setup_auth.py` with your Client ID and Client Secret to authorize via browser.

3

Does Tick Tick Mcp support Dida365?

Yes — set `TICKTICK_BASE_URL=https://api.dida365.com/open/v1` and `TICKTICK_TOKEN_URL=https://dida365.com/oauth/token` to use Dida365.

4

Where are my tokens stored?

Tokens are stored locally at `~/.ticktick_mcp/tokens.json` and are automatically refreshed with a 60-second buffer.

5

What if my tokens expire?

Re-run `setup_auth.py` to get fresh tokens. The server also handles token refresh transparently.

Comments

More Developer Tools MCP servers

BetterBugs

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

discoverGPT

Joe Monastiero

discoverGPT is visualAI's MCP gateway for AI commerce: one connection gives Claude 40 tools spanning product search, data-quality review, AI-discovery feeds, and virtual try-on, all backed by a single canonical product c

Modelglass

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

1

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

3
Advertise