Dida365 (TickTick)

by iamjzx

201 downloads
Not rated
GitHub

About

Integrates with Dida365 (TickTick) task management API to create, update, retrieve, and delete tasks and projects after user authorization.

Details

Author
iamjzx
Repository
iamjzx/dida
Downloads
201
Categories
Productivity, Design, Developer Tools, AI, Infrastructure, Project Management, Frontend, Security

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Dida365 (TickTick)
    Command (node, npx, python, etc.) cmd
    Arguments
    • Argument 1 /c
    • Argument 2 npx
    • Argument 3 -y
    • Argument 4 @smithery/cli@latest
    • Argument 5 run
    • Argument 6 @iamjzx/dida
    • Argument 7 --config
    • Argument 8 {"token":"your token"}

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Prerequisites

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

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\"}"
  ]
}

5. Save the file and restart Claude Desktop

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "dida365 (ticktick)": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@smithery/cli@latest",
                "run",
                "@iamjzx/dida",
                "--config",
                "{\"token\":\"your token\"}"
            ],
            "shell": true,
            "command": "cmd"
        }
    }
}

Linux

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

Macos

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

Windows

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

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

5. 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\"}"
  ]
}

4. 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\"}"
  ]
}

5. 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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.