MCP.so
ログイン
T

Ticktick Mcp

@dev-mirzabicer

Ticktick Mcp について

A fully-featured MCP server for TickTick

基本情報

カテゴリ

開発者ツール

トランスポート

stdio

公開者

dev-mirzabicer

投稿者

MirzaBicer

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.

FAQ from Ticktick Mcp

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.

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.

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.

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.

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.

コメント

「開発者ツール」の他のコンテンツ