Home
Login

Claudeに提供されるGoogleタスク管理モデルコンテキストプロトコルサーバー

MITTypeScript 63zcaceres Last Updated: 2025-02-02

gtasks-mcp - Google Tasks モデルコンテキストプロトコルサーバー

プロジェクト概要

gtasks-mcp は、Claude AI 専用に設計された Google Tasks モデルコンテキストプロトコル(MCP)サーバーです。このプロジェクトにより、Claude は Google Tasks API と直接統合し、Google タスクの完全な管理機能を実現できます。

プロジェクトアドレス: https://github.com/zcaceres/gtasks-mcp

主な機能

コアツール(Tools)

1. search - タスクの検索

  • 機能説明: Google Tasks でタスクを検索します
  • 入力パラメータ:
    • query (string): 検索クエリ文字列
  • 戻り結果: 一致するタスクの詳細情報

2. list - タスクのリスト表示

  • 機能説明: Google Tasks のすべてのタスクをリスト表示します
  • 入力パラメータ:
    • cursor (string, オプション): ページネーションカーソル
  • 戻り結果: すべてのタスクのリスト

3. create - タスクの作成

  • 機能説明: Google Tasks で新しいタスクを作成します
  • 入力パラメータ:
    • taskListId (string, オプション): タスクリストID
    • title (string, 必須): タスクタイトル
    • notes (string, オプション): タスク備考
    • due (string, オプション): 締め切り日
  • 戻り結果: タスク作成確認情報

4. update - タスクの更新

  • 機能説明: 既存の Google Tasks タスクを更新します
  • 入力パラメータ:
    • taskListId (string, オプション): タスクリストID
    • id (string, 必須): タスクID
    • uri (string, 必須): タスクURI
    • title (string, オプション): 新しいタスクタイトル
    • notes (string, オプション): 新しいタスク備考
    • status (string, オプション): 新しいタスクステータス("needsAction" または "completed")
    • due (string, オプション): 新しい締め切り日
  • 戻り結果: タスク更新確認情報

5. delete - タスクの削除

  • 機能説明: Google Tasks のタスクを削除します
  • 入力パラメータ:
    • taskListId (string, 必須): タスクリストID
    • id (string, 必須): タスクID
  • 戻り結果: タスク削除確認情報

6. clear - 完了済みタスクのクリア

  • 機能説明: Google Tasks タスクリストの完了済みタスクをクリアします
  • 入力パラメータ:
    • taskListId (string, 必須): タスクリストID
  • 戻り結果: クリア操作確認情報

リソース(Resources)

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

  • タスクリソース (gtasks:///<task_id>)
    • Google Tasks の単一のタスクを表します
    • タイトル、ステータス、締め切り日、備考、その他のメタデータを含むタスクの詳細情報の読み取りをサポートします
    • 提供されているツールを使用して、リスト表示、読み取り、作成、更新、および削除操作を実行できます

インストールと設定

前提条件

  1. Google Cloud プロジェクトの作成

  2. Google Tasks API の有効化

  3. OAuth 同意画面の設定

    • OAuth 同意画面 で設定を行います
    • テスト環境では "internal" を選択してください
    • スコープを追加:https://www.googleapis.com/auth/tasks
  4. OAuth クライアント ID の作成

    • 認証情報ページ で作成します
    • アプリケーションの種類で "デスクトップアプリ" を選択します
    • OAuth キーの JSON ファイルをダウンロードします
    • キーファイルを gcp-oauth.keys.json にリネームし、プロジェクトのルートディレクトリに配置します

プロジェクトのビルド

次のコマンドを使用してサーバーをビルドします。

npm run build

または、監視モードを使用します。

npm run watch

自動インストール(推奨)

Smithery を使用して自動的にインストールします。

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

認証

  1. サーバーを実行して認証を行います。
npm run start auth
  1. これにより、システムブラウザで認証フローが開きます
  2. 認証プロセスを完了します
  3. 認証情報はプロジェクトのルートディレクトリ(.gdrive-server-credentials.json)に保存されます

Claude Desktop 統合

このサーバーを Claude Desktop アプリケーションと統合するには、アプリケーションのサーバー構成に以下を追加します。

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

技術的特徴

  • 完全な CRUD 操作:タスクの作成、読み取り、更新、削除をサポート
  • 高度な検索機能:キーワードに基づいてタスクを検索できます
  • タスクステータス管理:タスクを完了または未処理としてマークすることをサポート
  • ページネーションサポート:大量のタスクを処理する際にページネーション機能を提供
  • OAuth 2.0 認証:安全な Google API アクセス
  • TypeScript サポート:タイプセーフとより良い開発体験を提供

使用シナリオ

  • 個人タスク管理:Claude の自然言語インタラクションを通じて、日々の ToDo を管理
  • プロジェクトコラボレーション:チームプロジェクトで AI アシスタントを通じてタスクの割り当てを管理
  • 自動化されたワークフロー:他のツールと組み合わせてタスク管理を自動化
  • 生産性向上:音声またはテキストを通じてタスクを迅速に作成および更新

注意事項

  • 有効な Google アカウントと Google Tasks へのアクセス権が必要です
  • 初めて使用する場合は、OAuth 認証フローを完了する必要があります
  • 本番環境では、認証情報を安全に保管することをお勧めします
  • Google API の使用クォータと制限に従ってください