Dida365 Agent

FreeNot checked

MCP server that enables AI agents to manage Dida365/TickTick tasks, projects, tags, and habits through natural language, with full CRUD, search, and advanced V2

by linhai0872

GitHub Embed

About

MCP server that enables AI agents to manage Dida365/TickTick tasks, projects, tags, and habits through natural language, with full CRUD, search, and advanced V2 capabilities.

README

dida365-agent

Let AI agents manage your Dida365 / TickTick — CLI · Skill · MCP

English | 中文

Let AI agents manage Dida365 / TickTick tasks, projects, tags, and habits through natural language. Three form factors: a lightweight CLI, a ready-to-install Agent Skill, and a standard MCP Server.

No install required — run it directly with uvx. Supports both Dida365 (China) and TickTick (International), switchable with one env var.

Features

Full task management	Create, update, complete, delete, and move tasks with priority, tags, dates, reminders, recurrence, and checklist items — plus batch operations.
Projects & queries	CRUD projects (list / kanban / timeline views), filter by project, date, priority, tag, and status, and review completed tasks.
V2 advanced power	Server-side full-text search, tag management, habit check-ins, project folders, parent/child tasks, task pinning — capabilities the official Open API doesn't cover.
Three form factors	CLI (run-and-exit, saves resources and context), Agent Skill (one-command install with built-in methodology), MCP Server (long-running, tool calls).
Dual platform	Switch between Dida365 (China) and TickTick (International) with `DIDA365_REGION`.
Agent-friendly	Structured JSON to stdout by default, errors to stderr with non-zero exit codes — easy for agents to parse and orchestrate.

Quick Start

Option 1: Use the CLI directly

No install needed — run with uvx (requires uv). First prepare credentials per the configuration guide and write them to .env:

# Browser OAuth (saves token, ~180 days)
uvx dida365-agent dida auth login

# List all projects
uvx dida365-agent dida project list

# Create a high-priority task due tomorrow
uvx dida365-agent dida task create --title "Review PR" --project <projectId> \
  --priority 5 --due-date "2026-05-30T18:00:00+0800"

# Full-text search (V2)
uvx dida365-agent dida search "meeting"

After installing locally (uv tool install dida365-agent), use the shorter dida command.

Option 2: Use as an Agent Skill

Install the Skill in any Skill-compatible AI tool (Claude Code, Cursor, etc.) and drive it with natural language:

# Install the Skill
npx skills add linhai0872/dida365-agent

Then just describe what you need in the AI chat:

Tidy up my unfinished tasks for today, list the high-priority ones, and move the overdue ones to the "Later" project

The Skill recognizes intent, fills in missing details, and assembles dida commands automatically — no manual parameters required.

Option 3: As an MCP Server

Exposes 44 tools as a standard MCP Server for Claude Code, Cursor, Windsurf, etc. See MCP Server integration.

Documentation

Doc	Contents
CLI Reference	All commands, parameters, conventions
Configuration	Credentials, enabling V2, env vars, token lifecycle
MCP Server	Local / source / Docker deployment, AI tool config

Development

uv sync                              # Install dependencies
uv run python -m pytest tests/       # Run tests
uv run ruff check src/ tests/        # Lint
uv run dida --help                   # Run the CLI locally

License

MIT

Acknowledgments

Dida365 / TickTick Open API
FastMCP · Typer · Model Context Protocol

from github.com/linhai0872/dida365-agent

Install Dida365 Agent in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install dida365-agent

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add dida365-agent -- uvx dida365-agent

FAQ

Is Dida365 Agent MCP free?

Yes, Dida365 Agent MCP is free — one-click install via Unyly at no cost.

Does Dida365 Agent need an API key?

No, Dida365 Agent runs without API keys or environment variables.

Is Dida365 Agent hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Dida365 Agent in Claude Desktop, Claude Code or Cursor?

Open Dida365 Agent on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Fetch

Web content fetching and conversion for efficient LLM usage.

by Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

by modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

by Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

by xuzexin-hz

Compare Dida365 Agent with

Dida365 AgentvsFetch Dida365 AgentvsAWS KB Retrieval Dida365 AgentvsSpring AI MCP Server Dida365 Agentvsllm-analysis-assistant

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs