MCP.so
ログイン

TickTick MCP Server

@rafliruslan

TickTick MCP Server について

MCP server for TickTick integration

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

rafliruslan

設定

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

{
  "mcpServers": {
    "ticktick-mcp-server-rafliruslan": {
      "command": "node",
      "args": [
        "oauth-helper.js"
      ]
    }
  }
}

ツール

9

Get all tasks or tasks from a specific project (with enhanced display)

Get overdue tasks with timezone compensation (configurable offset, defaults to UTC+8 - adjust for your timezone)

Get tasks due today with D+1 timezone adjustment

Get all projects from TickTick

Create a new task with priority, tags, due dates

Update an existing task

Delete a task

Mark a task as completed

Get a specific task by ID

概要

What is TickTick MCP Server?

TickTick MCP Server is a Model Context Protocol (MCP) server that integrates AI assistants with the TickTick task management service. It enables listing, creating, updating, deleting, and completing tasks, managing projects, and handling timezone complexities—all through a standardized MCP interface.

How to use TickTick MCP Server?

Install dependencies with npm install, copy .env.example to .env, configure authentication (OAuth recommended or username/password), build with npm run build, then start with npm start. Integrate with MCP clients (e.g., Claude Desktop, Cursor IDE) by adding a server entry to their configuration file pointing to the built dist/index.js.

Key features of TickTick MCP Server

  • List tasks/projects with human‑readable priorities
  • Create, update, delete, and complete tasks
  • Get overdue tasks with configurable timezone offset
  • Get today’s tasks with automatic D+1 compensation
  • Supports OAuth and username/password authentication
  • Full TypeScript coverage with robust error handling

Use cases of TickTick MCP Server

  • Manage TickTick tasks directly from an AI chat interface
  • Automatically fetch overdue or today’s tasks with correct timezone
  • Create and update tasks with priorities, tags, and due dates
  • Integrate task management into Claude Desktop or Cursor workflows

FAQ from TickTick MCP Server

What authentication methods does TickTick MCP Server support?

It supports OAuth (recommended) via access/refresh tokens plus client credentials, and username/password authentication.

What runtime environment is required?

Node.js and npm are required. The server is built and run locally, then connected to MCP clients.

How does the server handle timezone differences?

It applies a manual D+1 adjustment to due dates and accepts a configurable timezoneOffsetHours parameter (default UTC+8) in get_overdue_tasks for accurate results.

Where are task data stored?

All data is stored in the remote TickTick cloud service; the server only acts as a bridge.

Which transport does the server use?

The server communicates via standard input/output (stdio) as an MCP subprocess, launched by a host like Claude Desktop or Cursor.

コメント

「その他」の他のコンテンツ