Tick Tick Mcp

Name: Tick Tick Mcp
Author: Salen-Project

@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.

Basic information

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.

Comments

More Developer Tools MCP servers

Serena

oraios

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

26.2K

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K

test

harlanc

A simple,high performance and secure live media server in pure Rust (RTMP[cluster]/RTSP/WebRTC[whip/whep]/HTTP-FLV/HLS).🦀

2.3K

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K