Dida365 (TickTick) MCP Server

This is a Model Context Protocol (MCP) server that provides tools for interacting with the Dida365 (TickTick) API. It allows AI assistants to manage tasks and projects in Dida365 after user authorization.

Features

User authentication with Dida365
Get all projects (lists)
Get tasks from collection box
Create new tasks with various parameters
Update existing tasks in collection box
Delete tasks in collection box
Create new projects

Prerequisites

Node.js (v14 or higher)
npm or yarn
Dida365 (TickTick) account

Installation

Clone this repository
Install dependencies:

npm install

Usage

Get your token

Open https://developer.dida365.com/manage and click "New App" to create your Dida365 (TickTick) app.
Click "Edit" app and configure the OAuth redirect URL "http://106.75.247.14:3999/oauth/callback"
Get your Client ID and Client Secret
Open "https://dida365.com/oauth/authorize?scope=tasks:read tasks:write&client_id={client_id}&state=state&redirect_uri=http://106.75.247.14:3999/oauth/callback&response_type=code"

Don't forget to replace {client_id} with you client_id

The server will return a form

Fill in your client_id and client_secret, then sumit to get your token.

Setup for Different Clients

Cursor

Open Cursor and go to Settings > MCP
Click on "Add new global MCP server"
Add the follwing configuration to mcp.json:

"dida365": {
  "command": "cmd",
  "args": [
    "/c",
    "npx",
    "-y",
    "@smithery/cli@latest",
    "run",
    "@iamjzx/dida",
    "--config",
    "{\"token\":\"your token\"}"
  ]
}

Save the file and enable the mcp.

Claude Desktop

Open Claude Desktop and go to Settings > Developer
Enable Developer Mode
Click on "Edit Config" to open your claude_desktop_config.json
Add the following configuration to the "mcpServers" section:

"dida365": {
  "command": "cmd",
  "args": [
    "/c",
    "npx",
    "-y",
    "@smithery/cli@latest",
    "run",
    "@iamjzx/dida",
    "--config",
    "{\"token\":\"your token\"}"
  ]
}

Save the file and restart Claude Desktop

Logs

You can view the service runtime logs in the src/server.log file.

Unfinished

Due to the lack of api, we can't do the following:

Get tasks from a specific project
Update existing tasks in a specific project
Delete tasks in a specific project
Create new tasks in a specific project

Integrations