TickTick MCP Server

TickTick MCP サーバー

人気のタスク管理アプリケーションである TickTick 向けの Model Context Protocol（MCP）サーバー実装です。このサーバーを使うと、AI アシスタントが TickTick Open API を通じて TickTick とやり取りできます。

📋 機能

• プロジェクトからタスクを取得
• 期限、優先度、説明などの詳細を指定して新しいタスクを作成
• 既存のタスクを更新
• タスクを完了としてマーク
• タスクを削除
• プロジェクトの一覧を取得
• カスタムプロパティを指定して新しいプロジェクトを作成

🚀 クイックスタート

前提条件

• Node.js（v18 以降）
• TickTick 開発者アカウント
• TickTick API アクセストークン

インストール

1. このリポジトリをクローンします。

   git clone https://github.com/shidhincr/ticktick-mcpserver.git
   cd ticktick-mcpserver
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

4. アクセストークンを環境変数に設定します。

   export TICKTICK_ACCESS_TOKEN=your_access_token_here
   

5. サーバーを起動します。

   npm start
   

🔑 認証の設定

1. TickTick 開発者アカウントを登録する

1. TickTick Developer Center にアクセスします
2. アカウントを作成し、アプリケーションを登録します
3. クライアント ID とクライアントシークレットを取得します

2. アクセストークンを取得する

OAuth2 フローに従ってアクセストークンを取得します。

1. ユーザーを TickTick の認証ページにリダイレクトします。

   https://ticktick.com/oauth/authorize?scope=tasks:read tasks:write&client_id=YOUR_CLIENT_ID&state=STATE&redirect_uri=YOUR_REDIRECT_URI&response_type=code
   

2. 受け取ったコードをアクセストークンと交換します。 https://ticktick.com/oauth/token に次の内容で POST リクエストを送信します。

   • ヘッダー：クライアント ID とクライアントシークレットを使った Basic 認証
   • 本文（application/x-www-form-urlencoded）：
     • code：受け取った認証コード
     • grant_type：authorization_code
     • scope：tasks:read tasks:write
     • redirect_uri：リダイレクト URI

3. 受け取ったアクセストークンを安全に保管します。

🛠️ 利用可能なツール

このサーバーは、AI とのやり取りに次のツールを実装しています。

タスク管理

1. ticktick_get_tasks - 特定のプロジェクトまたはすべてのプロジェクトからタスクを取得

   {
     project_id?: string; // Optional project ID
     limit?: number;      // Optional result limit (default: 10)
   }
   

2. ticktick_create_task - 新しいタスクを作成

   {
     title: string;       // Required: Task title
     content?: string;    // Optional: Task content
     desc?: string;       // Optional: Task description
     project_id: string;  // Required: Project ID
     due_date?: string;   // Optional: Due date (ISO format)
     priority?: number;   // Optional: Priority (0, 1, 3, 5)
     is_all_day?: boolean; // Optional: All-day task flag
   }
   

3. ticktick_update_task - 既存のタスクを更新

   {
     project_id: string;  // Required: Project ID
     task_id: string;     // Required: Task ID
     title?: string;      // Optional: New title
     // ... other task properties
   }
   

4. ticktick_complete_task - タスクを完了としてマーク

   {
     project_id: string;  // Required: Project ID
     task_id: string;     // Required: Task ID
   }
   

5. ticktick_delete_task - タスクを削除

   {
     project_id: string;  // Required: Project ID
     task_id: string;     // Required: Task ID
   }
   

プロジェクト管理

1. ticktick_get_projects - すべてのプロジェクトの一覧を取得

2. ticktick_create_project - 新しいプロジェクトを作成

   {
     name: string;        // Required: Project name
     color?: string;      // Optional: Color code (e.g. "#F18181")
     view_mode?: string;  // Optional: View mode ("list", "kanban", "timeline")
     kind?: string;       // Optional: Project kind ("TASK", "NOTE")
   }
   

📁 プロジェクト構成

ticktick-mcpserver/
├── dist/                     # Compiled TypeScript (generated after building)
├── src/
│   └── index.ts              # Main server implementation
├── package.json              # Project dependencies and scripts
├── tsconfig.json             # TypeScript configuration
└── README.md                 # Documentation

🤝 コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

📚 API リファレンス

このプロジェクトでは TickTick Open API を使用しています。API エンドポイントとパラメーターの詳細については、公式ドキュメントを参照してください。

📝 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については LICENSE ファイルを参照してください。

🙏 謝辞

• API を提供している TickTick
• プロトコル仕様を提供している Model Context Protocol (MCP)