Dida365

GitHub
Integrates with
Dida365, TickTick

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