gtasks-mcp - GoogleタスクMCPサーバー | Claude AIタスク管理連携

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

インストールと設定

前提条件

Google Cloud プロジェクトの作成
- Google Cloud Console にアクセスして新しいプロジェクトを作成します
Google Tasks API の有効化
- Google Cloud Console で API を有効にします
OAuth 同意画面の設定
- OAuth 同意画面で設定を行います
- テスト環境では "internal" を選択してください
- スコープを追加：https://www.googleapis.com/auth/tasks
OAuth クライアント ID の作成
- 認証情報ページで作成します
- アプリケーションの種類で "デスクトップアプリ" を選択します
- OAuth キーの JSON ファイルをダウンロードします
- キーファイルを gcp-oauth.keys.json にリネームし、プロジェクトのルートディレクトリに配置します

プロジェクトのビルド

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

npm run build

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

npm run watch

自動インストール（推奨）

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

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

認証

サーバーを実行して認証を行います。

npm run start auth

これにより、システムブラウザで認証フローが開きます
認証プロセスを完了します
認証情報はプロジェクトのルートディレクトリ（.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 の使用クォータと制限に従ってください