dida365 Agent Mcp

dida365-agent

AI エージェントで Dida365 / TickTick を管理できます — CLI · Skill · MCP

English | 中文

自然言語を使って、AI エージェントから Dida365 / TickTick のタスク、プロジェクト、タグ、習慣を管理できます。軽量なCLI、すぐにインストールできるエージェントスキル、標準のMCP サーバーという3つの形態で利用できます。

インストール不要 — uvx で直接実行できます。Dida365（中国）と TickTick（海外）の両方に対応しており、環境変数1つで切り替えられます。

---

特長

タスク管理機能の充実	優先度、タグ、日付、リマインダー、繰り返し、チェックリスト項目を指定したタスクの作成、更新、完了、削除、移動に対応し、一括操作も可能です。
プロジェクトとクエリ	プロジェクトの CRUD（リスト／カンバン／タイムライン表示）、プロジェクト、日付、優先度、タグ、ステータスによる絞り込み、完了したタスクの確認が可能です。
V2 の高度な機能	サーバー側の全文検索、タグ管理、習慣のチェックイン、プロジェクトフォルダー、親子タスク、タスクのピン留めに対応しています。これらは公式の Open API では利用できない機能です。
3つの形態	CLI（実行後終了し、リソースとコンテキストを節約）、エージェントスキル（メソッドが組み込まれたワンコマンドインストール）、MCP サーバー（常時実行、ツール呼び出し）を利用できます。
2つのプラットフォームに対応	DIDA365_REGION で Dida365（中国）と TickTick（海外）を切り替えられます。
エージェントに適した設計	デフォルトでは構造化 JSON を標準出力に出力し、エラーは標準エラー出力に出力して、ゼロ以外の終了コードを返します。エージェントでの解析と連携が容易です。

---

クイックスタート

方法1：CLIを直接使う

インストールは不要です — uvx で実行します（uv が必要です）。まず、設定ガイドに沿って認証情報を準備し、.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"

ローカルにインストールした後（uv tool install dida365-agent）は、短い dida コマンドを使えます。

方法2：エージェントスキルとして使う

スキルに対応した AI ツール（Claude Code、Cursor など）に Skill をインストールし、自然言語で操作します。

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

あとは、AI チャットで必要なことを伝えるだけです。

今日の未完了タスクを整理して、優先度の高いものを一覧表示し、期限を過ぎたものを「Later」プロジェクトに移動してください

Skill が意図を認識し、不足している詳細を補って、自動的に dida コマンドを組み立てます — 手動でパラメーターを指定する必要はありません。

方法3：MCP サーバーとして使う

Claude Code、Cursor、Windsurf などに標準の MCP サーバーとして44個のツールを公開します。MCP サーバーの連携方法をご覧ください。

---

ドキュメント

ドキュメント	内容
CLI リファレンス	すべてのコマンド、パラメーター、規則
設定	認証情報、V2 の有効化、環境変数、トークンのライフサイクル
MCP サーバー	ローカル／ソース／Docker でのデプロイ、AI ツールの設定

---

開発

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

ライセンス

MIT

謝辞

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