Dida MCP Server
@zhongwencool
About Dida MCP Server
A Model Context Protocol (MCP) server for interacting with TickTick/Dida365 task management service. This server provides tools to manage tasks, projects, and tags through the TickTick API.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"dida": {
"command": "node",
"args": [
"/path/to/dida-mcp-server/build/index.js"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Dida MCP Server?
Dida MCP Server is a Model Context Protocol (MCP) server that allows AI assistants to interact with the TickTick/Dida365 task management service. It provides tools to manage tasks, projects, and tags through the TickTick API, with built-in support for GTD methodology.
How to use Dida MCP Server?
Install dependencies with npm install, build with npm run build, then run npm run get-token to authenticate via OAuth or username/password. Start the server with npm start and connect any MCP-compatible client using a configuration that points to the server script at dist/index.js.
Key features of Dida MCP Server
- OAuth-based authentication with TickTick/Dida365 API
- Full CRUD for tasks and projects
- Batch operations for tasks (update, delete, move)
- Built-in GTD Assistant system prompt
- Efficient caching of projects and tags data
Use cases of Dida MCP Server
- Let an AI assistant organize your inbox according to GTD principles
- Automate batch updates, moves, or deletions across multiple tasks
- Manage projects and tasks conversationally through any MCP-compatible client
FAQ from Dida MCP Server
What are the prerequisites to use Dida MCP Server?
You need Node.js v16 or higher, npm v7 or higher, and a TickTick/Dida365 account. For OAuth authentication, you also need a Client ID and Client Secret from the Dida365 Developer Center.
How does authentication work?
Two methods are supported: OAuth Authentication (V1 API) using tokens from the Dida365 Open API, and Username/Password Authentication (V2 API) using session tokens. The get-access-token script handles both and stores tokens in ~/.dida-mcp-config.json.
Where is the configuration stored?
Authentication tokens and configuration are stored in ~/.dida-mcp-config.json, which the server automatically detects and uses on startup.
What tools does the server provide?
Tools include check‑auth‑status, project management (list, create, update, delete, refresh‑cache), task management (list, create, get, update, complete, delete, move) and batch variants (batch‑update‑tasks, batch‑delete‑tasks, batch‑move‑tasks), plus a data query tool (list‑cached‑data).
Frequently asked questions
What are the prerequisites to use Dida MCP Server?
You need Node.js v16 or higher, npm v7 or higher, and a TickTick/Dida365 account. For OAuth authentication, you also need a Client ID and Client Secret from the Dida365 Developer Center.
How does authentication work?
Two methods are supported: OAuth Authentication (V1 API) using tokens from the Dida365 Open API, and Username/Password Authentication (V2 API) using session tokens. The `get-access-token` script handles both and stores tokens in `~/.dida-mcp-config.json`.
Where is the configuration stored?
Authentication tokens and configuration are stored in `~/.dida-mcp-config.json`, which the server automatically detects and uses on startup.
What tools does the server provide?
Tools include check‑auth‑status, project management (list, create, update, delete, refresh‑cache), task management (list, create, get, update, complete, delete, move) and batch variants (batch‑update‑tasks, batch‑delete‑tasks, batch‑move‑tasks), plus a data query tool (list‑cached‑data).
Basic information
More Other MCP servers
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Nginx UI
0xJackyYet another WebUI for Nginx
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
Comments