TickTick Mcp V2

TickTick MCP v2

TickTick 用の Model Context Protocol（MCP）サーバーです。v2 インターフェースを使用して、Claude やその他の MCP クライアントから TickTick のタスク管理システムを直接操作できます。

プロジェクトの目的

1. 簡単な認証：ユーザー名とパスワードで直接認証できます。

2. 豊富な API 機能：v2 インターフェースを使うと、より複雑な機能を簡単に実装できます。たとえば、他の v1 TickTick インターフェースでは、インボックスのタスクを取得することすらできません。

機能

• 📋 TickTick のすべてのプロジェクトとタスクを表示
• ✏️ 自然言語を使ってプロジェクトやタスクを新規作成
• 🔄 既存のタスクの詳細（タイトル、内容、日付、優先度）を更新
• ✅ タスクを完了済みにする
• 🗑️ タスクとプロジェクトを削除
• 🔐 ローカルでの認証情報保存に対応したユーザー名／パスワード認証

クイックスタート

mcp.json ファイルを作成します。

{
  "mcpServers": {
    "ticktick-mcp-v2": {
      "command": "uvx",
      "args": ["--from", "ticktick-mcp-v2", "ticktick-mcp", "run"],
      "env": {
        "TICKTICK_USERNAME": "your_username",
        "TICKTICK_PASSWORD": "your_password"
      }
    }
  }
}

使い始める

これで TickTick のタスクを直接操作できます。次のように尋ねてみてください。

• 「TickTick のプロジェクトをすべて表示して」
• 「『ドキュメントを完成させる』という名前で、優先度の高いタスクを作成して」
• 「今日が期限のタスクは何？」

開発環境のセットアップ

1. インストールして認証します。

   uvx --from ticktick-mcp-v2 ticktick-mcp auth
   

2. 接続をテストします。

   uvx --from ticktick-mcp-v2 ticktick-mcp test
   

3. サーバーを実行します。

   uvx --from ticktick-mcp-v2 ticktick-mcp run
   

使用例

他の MCP クライアントでの使用

上記の設定を使って、MCP 互換クライアントを接続できます。

利用可能な MCP ツール

ツール	説明	パラメーター
認証
auth_status	認証状態を確認	なし
プロジェクト管理
get_projects	すべてのプロジェクトを一覧表示	なし
get_project	プロジェクトの詳細を取得	project_id
create_project	プロジェクトを新規作成	name、color（任意）、view_mode（任意）
delete_project	プロジェクトを削除	project_id
get_project_tasks	プロジェクト内のタスクを取得	project_id、include_completed（任意）
タスク管理
get_tasks	すべてのタスクを一覧表示	include_completed（任意）
create_task	タスクを新規作成	title、project_id（任意）、content（任意）、start_date（任意）、due_date（任意）、priority（任意）
update_task	タスクを更新	task_id、project_id（任意）、title（任意）、content（任意）、start_date（任意）、due_date（任意）、priority（任意）
delete_task	タスクを削除	project_id、task_id
complete_task	タスクを完了済みにする	task_id
高度な機能
search_tasks	タスクを検索	query
get_tasks_by_priority	優先度でタスクを取得	priority（0=なし、1=低、3=中、5=高）
get_tasks_due_today	今日が期限のタスクを取得	なし
get_overdue_tasks	期限切れのタスクを取得	なし

プロンプトの例

• 「TickTick のプロジェクトをすべて表示して」
• 「『ドキュメントを完成させる』という名前で、優先度の高いタスクを作成して」
• 「今日が期限のタスクは何？」
• 「『食料品を買う』タスクを完了済みにして」
• 「『会議メモ』タスクの期限を明日に変更して」

謝辞

以下の優れたオープンソースプロジェクトがなければ、このプロジェクトは実現できませんでした。

🎯 ticktick-py

オリジナル作者：Michael Lazeroff
フォークのメンテナー：yidianyiko

この MCP サーバーを支える TickTick のコア Python SDK です。この非公式 API ライブラリは TickTick の機能に包括的にアクセスでき、TickTick タスク管理プラットフォームとのシームレスな統合を実現します。

🤝 貢献

このプロジェクトが役に立った場合は、次のようなご協力をご検討ください。

• 🐛 問題の報告や改善案の提案
• 📖 貢献

ライセンス

MIT ライセンスの詳細については、LICENSE ファイルをご覧ください。