dida365 Agent Mcp

Name: dida365 Agent Mcp
Author: linhai0872

@linhai0872

关于 dida365 Agent Mcp

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.

#dida365 #ticktick #task-management #productivity #todo #ai-agent #python

基本信息

分类

AI 与智能体

传输方式

stdio

发布者

linhai0872

提交者

Hai Lin

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is dida365 Agent Mcp?

dida365 Agent Mcp is an MCP (Model Context Protocol) server that provides 40 tools to interact with the Dida365 (China) and TickTick (International) task management platforms. It combines official V1 Open API tools with private V2 API tools for advanced features like tags, habits, folders, and parent tasks. Designed for developers and power users who want to automate task management via AI agents.

How to use dida365 Agent Mcp?

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.

Key features of dida365 Agent Mcp

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

Use cases of dida365 Agent Mcp

Automate task creation, update, completion, and filtering across multiple projects
Manage tags, habits, folders, and parent-child task relationships
Search and move tasks using private V2 API endpoints
Integrate task management into AI agent workflows on both China and international platforms

FAQ from dida365 Agent Mcp

What is the difference between V1 and V2 tools?

V1 tools use the official Dida365/TickTick Open API and cover standard task and project operations. V2 tools use private APIs that enable extras like tags, habits, folders, and search.

How do I authenticate with the server?

Run uvx --from dida365-agent-mcp dida365-oauth once. This opens a browser for OAuth login and saves the token locally for repeated use (valid ~180 days).