Google Tasks MCP Server

Google Tasks MCP サーバー

この MCP サーバーは Google Tasks と連携し、タスクの一覧表示、読み取り、検索、作成、更新、削除を可能にします。

コンポーネント

ツール

• search

  • Google Tasks のタスクを検索します
  • 入力：query（string）：検索クエリ
  • 一致するタスクの詳細を返します

• list

  • Google Tasks のすべてのタスクを一覧表示します
  • 任意の入力：cursor（string）：ページネーション用カーソル
  • すべてのタスクのリストを返します

• create

  • Google Tasks に新しいタスクを作成します
  • 入力：
    • taskListId（string、任意）：タスクリスト ID
    • title（string、必須）：タスクのタイトル
    • notes（string、任意）：タスクのメモ
    • due（string、任意）：期限
  • タスクが作成されたことを確認するメッセージを返します

• update

  • Google Tasks の既存のタスクを更新します
  • 入力：
    • taskListId（string、任意）：タスクリスト ID
    • id（string、必須）：タスク ID
    • uri（string、必須）：タスク URI
    • title（string、任意）：新しいタスクのタイトル
    • notes（string、任意）：新しいタスクのメモ
    • status（string、任意）：新しいタスクのステータス（"needsAction" または "completed"）
    • due（string、任意）：新しい期限
  • タスクが更新されたことを確認するメッセージを返します

• delete

  • Google Tasks のタスクを削除します
  • 入力：
    • taskListId（string、必須）：タスクリスト ID
    • id（string、必須）：タスク ID
  • タスクが削除されたことを確認するメッセージを返します

• clear

  • Google Tasks のタスクリストから完了済みのタスクを消去します
  • 入力：taskListId（string、必須）：タスクリスト ID
  • タスクが消去されたことを確認するメッセージを返します

リソース

このサーバーは Google Tasks のリソースへのアクセスを提供します。

• タスク（gtasks:///<task_id>）
  • Google Tasks の個々のタスクを表します
  • タイトル、ステータス、期限、メモ、その他のメタデータを含むタスクの詳細を読み取れます
  • 提供されているツールを使って、一覧表示、読み取り、作成、更新、削除できます

はじめに

1. 新しい Google Cloud プロジェクトを作成します
2. Google Tasks API を有効にします
3. OAuth 同意画面を設定します（テストには「internal」で問題ありません）
4. スコープ https://www.googleapis.com/auth/tasks を追加します
5. アプリケーションの種類を「Desktop App」としてOAuth クライアント ID を作成します
6. クライアントの OAuth キーを含む JSON ファイルをダウンロードします
7. キーファイルの名前を gcp-oauth.keys.json に変更し、このリポジトリのルートに配置します（例：gcp-oauth.keys.json）

npm run build または npm run watch を使って、必ずサーバーをビルドしてください。

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用 Google Tasks サーバーを自動的にインストールするには：

npx -y @smithery/cli install @zcaceres/gtasks --client claude

認証

認証して認証情報を保存するには：

1. auth 引数を付けてサーバーを実行します：npm run start auth
2. システムのブラウザーで認証フローが開きます
3. 認証手続きを完了します
4. 認証情報がこのリポジトリのルートに保存されます（例：.gdrive-server-credentials.json）

デスクトップアプリでの使用

このサーバーをデスクトップアプリと連携するには、アプリのサーバー設定に以下を追加します。

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}