Tick Tick Mcp

@Salen-Project

About Tick Tick Mcp

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

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>"
      }
    }
  }
}

Tools

No tools detected

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

FAQ from Tick Tick Mcp

What are the prerequisites for Tick Tick Mcp?

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

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.

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.

Where are my tokens stored?

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

What if my tokens expire?

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

Frequently asked questions

What are the prerequisites for Tick Tick Mcp?

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

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.

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.

Where are my tokens stored?

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

What if my tokens expire?

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

Comments

Basic information

More Developer Tools MCP servers

PuzzleTide Puzzle Generator

Caravaca-Labs

Word search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers

Hello World MCP Server (Reference Extension)

anthropics

Desktop Extensions: One-click local MCP server installation in desktop apps

2.0K

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K