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

We recommend that you clone the repository and run it locally:

Installation

1. Clone this repository
2. Install dependencies:

npm install

Usage

Get your token

1. Open https://developer.dida365.com/manage and click "New App" to create your Dida365 (TickTick) app.
2. Click "Edit" app and configure the OAuth redirect URL "http://106.75.247.14:3999/oauth/callback"
3. Get your Client ID and Client Secret
4. Open "https://dida365.com/oauth/authorize?scope=tasks%3Aread%20tasks%3Awrite&client_id={client_id}&state=state&redirect_uri=http%3A%2F%2F106.75.247.14%3A3999%2Foauth%2Fcallback&response_type=code"

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

The server will return a form

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

Setup for Different Clients

Cursor

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

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

1. Save the file and enable the mcp.

Claude Desktop

1. Open Claude Desktop and go to Settings > Developer
2. Enable Developer Mode
3. Click on "Edit Config" to open your claude_desktop_config.json
4. 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\"}"
  ]
}

1. 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:

1. Get tasks from a specific project
2. Update existing tasks in a specific project
3. Delete tasks in a specific project
4. Create new tasks in a specific project