Dida365 (TickTick)

🚀 Dida365 (TickTick) MCP Server

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

✨ Features

• User authentication via Dida365
• Retrieve all projects (lists)
• Fetch tasks from the inbox
• Create new tasks with various parameters
• Update existing tasks in the inbox
• Delete tasks from the inbox
• Create new projects

📋 Prerequisites

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

🚀 Quick Start

We recommend you clone the repository and run it locally:

📦 Installation

1. Clone this repository.
2. Install dependencies:

npm install

💻 Usage Examples

🎫 Get Your Token

1. Open https://developer.dida365.com/manage and click "New App" to create your Dida365 (TickTick) application.
2. Click "Edit" on the application and configure the OAuth redirect URL to "http://106.75.247.14:3999/oauth/callback".
3. Obtain 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".

Please remember to replace {client_id} with your own client ID.

The server will return a form.

5. Fill in your client ID and client secret, then submit to get your token.

⚙️ Configuration for Different Clients

Cursor

1. Open Cursor and go to Settings > MCP.
2. Click "Add New Global MCP Service".
3. Add the following configuration to mcp.json:

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

4. Save the file and enable MCP.

Claude Desktop

1. Open Claude Desktop and go to Settings > Developer.
2. Enable developer mode.
3. Click "Edit Configuration" 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\"}"
  ]
}

5. Save the file and restart Claude Desktop.

📄 Logs

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

⚠️ Unimplemented Features

Due to API limitations, we are unable to implement the following features:

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