Advertise
MCP.so
Sign In
T

Ticktick MCP Server

@dev-mirzabicer

Repository

Basic information

Category

Developer Tools

Transports

stdio

Author

dev-mirzabicer

Submitted by

MirzaBicer

About Ticktick MCP Server

A fully-featured MCP server for TickTick

#ticktick#mcp#python-sdk

Ticktick MCP Server config

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

{
  "mcpServers": {
    "ticktick": {
      "command": "ticktick-sdk",
      "env": {
        "TICKTICK_CLIENT_ID": "your_client_id",
        "TICKTICK_CLIENT_SECRET": "your_client_secret",
        "TICKTICK_ACCESS_TOKEN": "your_access_token",
        "TICKTICK_USERNAME": "your_email",
        "TICKTICK_PASSWORD": "your_password"
      }
    }
  }
}

Ticktick 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 Ticktick Mcp?

Ticktick Mcp is an MCP (Model Context Protocol) server built on the ticktick-sdk Python library that enables AI assistants like Claude and GPT to manage TickTick tasks programmatically. It provides 45 tools covering task management, project organization, habits, focus/pomodoro, tags, and more, routing operations automatically between TickTick's official V1 API and the undocumented V2 API.

How to use Ticktick Mcp?

Install via pip install ticktick-sdk with Python 3.11+. Configure authentication by registering an OAuth2 app on the TickTick Developer Portal and creating a .env file with your client ID, secret, redirect URI, access token, username, and password. Run python scripts/get_oauth_token.py for the token, then verify with python -c .... The MCP server can then be invoked through any MCP-compatible host; the library itself exposes 45 tools for AI assistants.

Key features of Ticktick Mcp

  • 45 MCP tools covering all TickTick features
  • Dual output: Markdown for humans, JSON for machines
  • Async-first with full Pydantic v2 validation
  • Unified routing to V1 (OAuth2) and V2 (session) APIs
  • Full habit CRUD with check-ins, streaks, and goals
  • Focus/pomodoro session data and statistics
  • 300+ tests with comprehensive type hints

Use cases of Ticktick Mcp

  • Let an AI assistant create, update, complete, and move tasks in TickTick.
  • Query tasks by tag, priority, due date, or search term via natural language.
  • Manage projects, folders, and kanban boards programmatically.
  • Track habits with check-ins and streak analytics through AI.
  • Access productivity stats and focus session data.

Frequently asked questions

1

What are the runtime requirements for Ticktick Mcp?

Python 3.11+ and a TickTick account (free or Pro). For full functionality, both OAuth2 app registration and account credentials are required.

2

How does Ticktick Mcp handle TickTick’s two APIs?

It combines the official V1 OAuth2 API and the undocumented V2 session API, automatically routing each operation to the appropriate API based on the feature needed.

3

Where do my credentials and data live?

All credentials are stored locally in a `.env` file. Data is accessed via TickTick’s APIs; the server does not store data externally.

4

What transport does Ticktick Mcp use?

The README does not specify the transport protocol beyond MCP compatibility; it is designed to work with MCP-compatible AI assistants.

5

How is Ticktick Mcp different from other TickTick libraries?

It is the only library that includes an MCP server, provides async support with Pydantic v2, full habit CRUD, focus/pomodoro access, and automatic V1/V2 routing.

Comments

More Developer Tools MCP servers

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

Just Domain.

Just.

Just Domain is the domain registrar for businesses built with AI. An AI assistant checks availability and both prices, first year and renewal, and hands back a checkout link for justdomain.ai. Read only by design: no pur

offprompt

offprompt

MCP server that lets Claude Code, Cursor or Codex ask you for API keys on a local page and write them to .env. The agent only ever sees key names.

2

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac

32

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

1
Advertise