MCP.so
Sign In
T

Ticktick Api Mcp (typescript)

@polza-ai

Repository

About Ticktick Api Mcp (typescript)

No overview available yet

#ticktick#api#typescript

Config

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

{
  "mcpServers": {
    "ticktick": {
      "command": "node",
      "args": [
        "/absolute/path/to/ticktick-mcp-ts/dist/index.js"
      ],
      "env": {
        "TICKTICK_ACCESS_TOKEN": "your_access_token_here",
        "TICKTICK_BASE_URL": "https://api.ticktick.com/open/v1"
      }
    }
  }
}

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 Ticktick Api Mcp (typescript)?

It is a Model Context Protocol (MCP) server written in TypeScript that integrates with the TickTick task management API. It allows AI clients like Claude to manage projects and tasks in TickTick through a standardized interface.

How to use Ticktick Api Mcp (typescript)?

Install with npm install and build with npm run build. Configure environment variables in a .env file with your TickTick Client ID, Client Secret, and Access Token. Run npm run get-token to obtain an access token via OAuth2. Then add the server to your MCP client’s configuration (e.g., Claude Desktop) pointing to the built dist/index.js file. Tools are invoked automatically by the client based on user requests.

Key features of Ticktick Api Mcp (typescript)

  • OAuth2 authentication using an access token
  • Full CRUD for projects and tasks
  • Special tools to fetch today’s and overdue tasks
  • Separate script (npm run get-token) to obtain credentials
  • Dynamic resources for configuration, projects, tasks, and stats
  • Supports both TickTick and its Chinese version Dida365

Use cases of Ticktick Api Mcp (typescript)

  • List all TickTick projects and their tasks via Claude
  • Create, update, or delete tasks and projects on demand
  • Get a summary of today’s deadlines or overdue items
  • Automate task planning: “Create a project with a set of tasks for my event”
  • Integrate TickTick task management into an AI‑powered workflow

FAQ from Ticktick Api Mcp (typescript)

What is the difference between TickTick and Dida365?

Dida365 is the Chinese version of TickTick. The server supports both by changing the base URL and auth endpoints in the .env file (e.g., TICKTICK_BASE_URL=https://api.dida365.com/open/v1). The OAuth flow is identical.

What runtime and dependencies are required?

Node.js 18 or higher, npm or yarn, and a TickTick API application (Client ID and Client Secret) registered at the TickTick Developer Center.

Where are user credentials and data stored?

Credentials (Client ID, Client Secret, Access Token) are stored locally in the .env file. No user data is stored by the server; it only makes API calls to TickTick’s servers.

Can I use the server without setting up a .env file?

Yes, each tool accepts an optional accessToken parameter. If omitted, the server reads TICKTICK_ACCESS_TOKEN from the environment. All other configuration (base URLs) must be set in the environment or default values are used.

How does authentication work?

The server uses OAuth2. Run npm run get-token to start a local server on port 8080, open a browser for TickTick login, and automatically save the access and refresh tokens. The server handles token refresh automatically when needed.

Frequently asked questions

What is the difference between TickTick and Dida365?

Dida365 is the Chinese version of TickTick. The server supports both by changing the base URL and auth endpoints in the `.env` file (e.g., `TICKTICK_BASE_URL=https://api.dida365.com/open/v1`). The OAuth flow is identical.

What runtime and dependencies are required?

Node.js 18 or higher, npm or yarn, and a TickTick API application (Client ID and Client Secret) registered at the TickTick Developer Center.

Where are user credentials and data stored?

Credentials (Client ID, Client Secret, Access Token) are stored locally in the `.env` file. No user data is stored by the server; it only makes API calls to TickTick’s servers.

Can I use the server without setting up a `.env` file?

Yes, each tool accepts an optional `accessToken` parameter. If omitted, the server reads `TICKTICK_ACCESS_TOKEN` from the environment. All other configuration (base URLs) must be set in the environment or default values are used.

How does authentication work?

The server uses OAuth2. Run `npm run get-token` to start a local server on port 8080, open a browser for TickTick login, and automatically save the access and refresh tokens. The server handles token refresh automatically when needed.

Comments

Basic information

Category

Developer Tools

Transports

stdio

Author

polza-ai

Submitted by

dddoker

More Developer Tools MCP servers

endoflife.ai

endoflife.ai

Free MCP server for software end-of-life intelligence: EOL dates, support status, and the 0-100 EOL Risk Score across 480+ tracked products. Agents can check a single version, pull a product's full lifecycle schedule, or

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

1

Routebase

Routebase

Routebase keeps your API's design, docs, contract tests, mocks and monitoring in one living OpenAPI spec so they can't drift apart. Agents work on that same source of truth, under your team's permissions.

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI — Career Intelligence MCP Server Structured career decision scaffolding for AI agents. Provides personality-conditioned business idea generation, official BLS OEWS wage data, FRED labor market signals, and

Apiosk

obcraft

AI-native payments for tools and APIs. Discover, pay for, execute, and publish monetized APIs directly from your agent, settled per call in USDC over x402, through the Model Context Protocol. payments · finance · x402 ·