dida365 Agent Mcp

by linhai0872

338 downloads
Not rated
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.

Details

Author
linhai0872
Downloads
338
Categories
AI, Project Management, Productivity

- 40 tools — 19 V1 (official Open API) + 21 V2 (private API)
- Dual platform — supports Dida365 and TickTick via one environment variable
- Dual transport — stdio for local clients, streamable-http for remote agents
- One-click OAuth — automatic browser flow, token cached for ~180 days
- Docker ready — deploy with a single docker compose up command

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

Run uvx --from dida365-agent-mcp dida365-oauth once to authenticate via a one-click browser OAuth flow. Then add the server to your MCP client configuration using uvx dida365-agent-mcp as the command and args. The token is saved locally and lasts approximately 180 days.

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 transportstdio for local clients; streamable-http for remote agents - One-click OAuth — auto browser flow, token saved for ~180 days - Docker readydocker 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.