Google Tasks MCP Server

Google Tasks MCP サーバー

Google Tasks を管理するための Model Context Protocol（MCP）サーバーです。

この TypeScript ベースの MCP サーバーは、Google Tasks API と連携することで、MCP の中核的な概念を実証します。タスクを構造化された効率的な方法で管理できます。

---

機能

リソース

• デフォルトのタスクリスト：URI tasks://default を介して、デフォルトの Google Tasks リスト内のタスクにアクセスします。
• タスクの詳細：タイトル、メモ、完了状況など、タスクに関するメタデータを提供します。
• JSON MIME タイプ：タスクは、機械可読な JSON 形式で表されます。

ツール

• create_task：デフォルトのタスクリストに新しいタスクを作成します。
  • パラメーター：
    • title（string、任意）：タスクのタイトル。
    • notes（string、任意）：タスクの追加メモ。
    • taskId（string、任意）：タスクの一意の ID。
    • status（string、任意）：タスクのステータス（例：「needsAction」または「completed」）。
  • 応答：作成したタスクの詳細を返します。
• list_tasks：デフォルトのタスクリスト内のすべてのタスクを一覧表示します。
  • パラメーター：なし。
  • 応答：デフォルトのタスクリスト内のすべてのタスクを含む JSON 配列を返します。
• delete_task：デフォルトのタスクリストからタスクを削除します。
  • パラメーター：
    • taskId（string、必須）：削除するタスクの ID。
  • 応答：タスクの削除が成功したことを確認します。
• update_task：デフォルトのタスクリスト内の既存のタスクを更新します。
  • パラメーター：
    • taskId（string、必須）：更新するタスクの ID。
    • title（string、任意）：タスクの新しいタイトル。
    • notes（string、任意）：タスクの新しいメモ。
  • 応答：更新したタスクの詳細を返します。
• complete_task：タスクの完了状況を切り替えます。
  • パラメーター：
    • taskId（string、必須）：完了状況を切り替えるタスクの ID。
  • 応答：新しいステータスを含む、更新後のタスクの詳細を返します。

---

機能の概要

• MCP を介して、LLM やその他のアプリケーションと簡単に連携できます。
• 構造化されたツール定義により、タスク管理を直感的かつ簡単に利用できます。
• タスクの作成、一覧表示、削除、更新、完了状況の切り替えを完全にサポートします。

---

使い方

サーバーの実行

サーバーを起動するには：

node build/index.js

利用可能なコマンド

• create_task： 任意のパラメーターを指定して新しいタスクを作成します。

  {
    "title": "Complete project",
    "notes": "Finalize module 3",
    "status": "needsAction"
  }
  

• list_tasks： デフォルトのタスクリスト内のすべてのタスクを取得します。
  • パラメーターは不要です。
  • タスクの配列を返します。
• delete_task： ID を指定してタスクを削除します。

  {
    "taskId": "unique-task-id"
  }
  

• update_task： ID を指定して、タスクのタイトル、メモ、その他の詳細を更新します。

  {
    "taskId": "unique-task-id",
    "title": "Updated task title",
    "notes": "Updated task notes"
  }
  

• complete_task： タスクの完了状況を切り替えます。

  {
    "taskId": "unique-task-id"
  }
  

complete_task の応答例

完了前

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "needsAction"
}

完了後

{
  "taskId": "unique-task-id",
  "title": "Finish the report",
  "status": "completed"
}

---

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグには追加のツールが必要です。MCP Inspector の使用をおすすめします。

Inspector を起動するには：

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を提供します。これにより、サーバーのテストとデバッグが容易になります。

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。MIT License の利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。