# Dida365 (TickTick) MCP — Task Management for Claude Code

> Connect Claude Code to Dida365/TickTick via MCP. OAuth auth, full CRUD for tasks and projects, batch operations. Works with Claude Code, Cursor, and other MCP-compatible tools.

## Install

Merge the JSON below into your `.mcp.json`:

# Dida365 (TickTick) MCP — Task Management for Claude Code

Connect Claude Code to Dida365 (TickTick) for full task management via Model Context Protocol.

## Package

[`dida365-mcp-server`](https://www.npmjs.com/package/dida365-mcp-server) v0.2.2 by [evalor](https://github.com/evalor/dida365-mcp-server)

## Installation

Add to your `.mcp.json` or Claude Code MCP settings:

```json
{
  "mcpServers": {
    "dida365": {
      "command": "npx",
      "args": ["-y", "dida365-mcp-server"]
    }
  }
}
```

## Setup

1. Run Claude Code — the MCP server starts automatically
2. Use `check_auth_status` to see if authorized
3. If not, use `get_auth_url` to get an OAuth login link
4. Open the URL in browser and authorize
5. Tokens saved to `~/.dida365-mcp/tokens.json`

## Available Tools

| Tool | Description |
|------|-------------|
| `check_auth_status` | Check authorization status |
| `get_auth_url` | Get OAuth login URL |
| `create_task` | Create a new task |
| `update_task` | Update an existing task |
| `complete_task` | Mark task as complete |
| `delete_task` | Delete a task |
| `get_task` | Get task details |
| `list_tasks` | List tasks in a project |
| `list_projects` | List all projects |
| `create_project` | Create a project |
| `update_project` | Update a project |
| `delete_project` | Delete a project |
| `get_project` | Get project details |
| `get_project_data` | Get all data in a project |

## Tips

- Times in UTC: `YYYY-MM-DDThh:mm:00.000+0000`
- Set `timeZone: "Asia/Shanghai"` for China
- Completed tasks: `status: 2` + `completedTime`
- Tags NOT supported via MCP — use direct API with token from `~/.dida365-mcp/tokens.json`
- Use `batch_add_tasks` / `batch_update_tasks` for bulk operations

---
Source: https://tokrepo.com/en/workflows/efc83153-1596-459a-9920-5db7d8d5a4fc
Author: shiny.lucc