dida365 Agent Mcp

by linhai0872

338 downloads Not rated yet
GitHub

About

MCP server that connects AI agents (Claude Code, Cursor, Codex) to Dida365/TickTick. 40 tools for tasks, projects, tags, habits, folders, and search — manage everything through natural language.

Explore

- 40 tools — 19 V1 (official Open API) + 21 V2 (private API: tags, search, habits, folders, parent tasks)
- Dual platform — Dida365 (China) and TickTick (International) via one env var
- Dual transport — stdio for local clients; streamable-http for remote agents
- One-click OAuth — auto browser flow, token saved for ~180 days
- Docker ready — docker compose up to deploy

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 Agent Mcp
    Command (node, npx, python, etc.)

    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

``bash
uvx --from dida365-agent-mcp dida365-oauth # OAuth (one-time)
`
Then add to your MCP client config:
`
{
"mcpServers": {
"dida365": {
"command": "uvx",
"args": ["dida365-agent-mcp"]
}
}
}
``

- Task: create, update, complete, delete, get, move, batch create/update/complete, filter, search
- Project: list, get, create, update, delete
- Tags (V2): list, create, update, delete
- Habits (V2): list, create, update, delete, checkin, undo checkin
- Folders (V2): list, create, update, delete
- Other (V2): parent/child tasks, pin task, search

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "dida365 agent mcp": {
            "dida365": {
                "command": "uvx",
                "args": [
                    "dida365-agent-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "dida365": {
        "command": "uvx",
        "args": [
            "dida365-agent-mcp"
        ]
    }
}

Features

- 40 tools — 19 V1 (official Open API) + 21 V2 (private API: tags, search, habits, folders, parent tasks) - Dual platform — Dida365 (China) and TickTick (International) via one env var - Dual transport — stdio for local clients; streamable-http for remote agents - One-click OAuth — auto browser flow, token saved for ~180 days - Docker ready — docker compose up to deploy

Quick Start

``bash uvx --from dida365-agent-mcp dida365-oauth # OAuth (one-time) ` Then add to your MCP client config: ` { "mcpServers": { "dida365": { "command": "uvx", "args": ["dida365-agent-mcp"] } } } ``

Tools Overview

- Task: create, update, complete, delete, get, move, batch create/update/complete, filter, search - Project: list, get, create, update, delete - Tags (V2): list, create, update, delete - Habits (V2): list, create, update, delete, checkin, undo checkin - Folders (V2): list, create, update, delete - Other (V2): parent/child tasks, pin task, search

Full documentation:

https://github.com/linhai0872/dida365-agent-mcp
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.