Dida365 MCP Servers

🚀 TickTick MCP Service

This is a Model Context Protocol (MCP) server developed for TickTick (TickTick/Dida365), written in TypeScript. This service allows AI assistants to interact with the TickTick API through a standardized interface.

✨ Features

• ✅ Create, read, update, and delete tasks
• ✅ Manage projects and project lists
• ✅ Support task priorities and due dates
• ✅ Securely configure API Tokens via environment variables
• ✅ Full TypeScript type support
• ✅ Error handling and API response validation

🚀 Quick Start

Using MCP (Node Version)

Obtain the token from DIDA official

OpenAPI - API Doc

Download

npm i dida365-mcp-servers

Configure the JSON file

    "dida365": {
      "command": "node",
      "args": [
 			//your download path ; example:C:\\nvm4w\\nodejs\\node_modules\\dida365-mcp-servers\\dist
      ],
      "env": {
        "DIDA365_TOKEN": your TOKEN
      }
    }

Using Locally

1. Install Dependencies

npm install

2. Configure Environment Variables

Copy the example environment variable file:

cp .env.example .env

Edit the .env file and add your TickTick API Token:

DIDA365_TOKEN=Bearer your_token_here

3. Obtain the API Token

1. Visit the TickTick Open Platform
2. Log in to your TickTick account
3. Create a new application
4. Obtain the Access Token
5. Add the token to the .env file

4. Build and Run

Development mode:

npm run dev

Production mode:

npm run build
npm start

💻 Usage Examples

Task Management

create_task - Create a new task

• Parameters:
  • title (string, required): Task title
  • projectId (string, required): Project ID
  • content (string): Task content description
  • dueDate (string): Due date (ISO 8601 format)
  • priority (number): Priority (0 - 5)

get_task_by_projectId_and_taskId - Get a task by project ID and task ID

• Parameters:
  • projectId (string, required): Project ID
  • taskId (string, required): Task ID

get_tasks_by_projectId - Get the task list in a project by project ID

• Parameters:
  • projectId (string, required): Project ID

update_task - Update a task

• Parameters:
  • taskId (string, required): Task ID
  • title (string): Task title
  • content (string): Task content
  • dueDate (string): Due date
  • priority (number): Priority
  • status (number): Task status (0: Incomplete, 1: Completed)

delete_task - Delete a task

• Parameters:
  • taskId (string, required): Task ID
  • projectId (string, required): Project ID

complete_task - Complete a task

• Parameters:
  • taskId (string, required): Task ID
  • projectId (string, required): Project ID

Project Management

get_projects - Get the project list

• Parameters: None

get_project_by_projectId - Get a project by project ID

• Parameters:
  • projectId (string, required): Project ID

create_project - Create a new project

• Parameters:
  • name (string, required): Project name
  • color (string): Project color, e.g., "#F18181"
  • sortOrder (integer): Sorting value, default is 0
  • viewMode (string): View mode ("list", "kanban", "timeline")
  • kind (string): Project type ("TASK", "NOTE")

update_project_by_projectID - Update a project by project ID

• Parameters:
  • projectId (string, required): Project ID
  • name (string): Project name
  • color (string): Project color
  • sortOrder (integer): Sorting value, default is 0
  • viewMode (string): View mode ("list", "kanban", "timeline")
  • kind (string): Project type ("TASK", "NOTE")

update_project_by_projectID - Delete a project by project ID

• Parameters:
  • projectId (string, required): Project ID

📚 Available Resources

dida365://tasks

Get an overview of all tasks in JSON format.

dida365://projects

Get an overview of all projects in JSON format.

📁 Project Structure

├── src/
│   └── index.ts          # Main server file
├── dist/                 # Compilation output directory
├── .env.example          # Environment variable example
├── package.json          # Project configuration
├── tsconfig.json        # TypeScript configuration
└── README.md            # Project documentation

📄 API Documentation

This service uses the official TickTick API:

• Base URL: https://api.dida365.com/open/v1
• Authentication method: Bearer Token
• Request format: JSON
• Official documentation: https://developer.dida365.com/api#/openap

🔧 Technical Details

The service includes a complete error handling mechanism:

• Return detailed error information when API calls fail
• Handle network errors and timeouts
• Perform parameter validation and type checking
• Validate Tokens

🛠️ Development Instructions

🤝 Contribution

Welcome to submit Issues and Pull Requests!