Google MCP

by vakharwalad23
Verified

Google MCPツール

これは、 MCP プロトコル用の Google ネイティブ ツール (Gmail、カレンダーなど) のコレクションであり、Claude や Cursor などの AI クライアントとシームレスに統合できるように設計されています。

{ "mcpServers": { "google-mcp": { "command": "bunx", "args": ["--no-cache", "google-mcp@latest"], "env": { // Either can be used, but not both // Use OAuth "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>", "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS> CAN_BE_ANYWHERE_ON_YOUR_SYSTEM", // Use Service Account "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>", "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>", "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>" } } } }

特徴

  • Gメール:
    • 複数の受信者 (宛先、CC、BCC) と添付ファイルを含む電子メールを送信します。
    • カスタム クエリ、ラベル、結果制限を使用してメールを一覧表示します。
    • ID 別に特定のメールを読み取ります。
    • ラベルを管理します(追加、削除、リスト)。
    • メールを下書きして削除します。
  • カレンダー:
    • カレンダーを一覧表示し、デフォルトのカレンダーを設定します。
    • 詳細(概要、開始/終了時間、出席者など)を含むイベントを作成します。
    • カスタマイズ可能なフィルターを使用して今後のイベントをリストします。
    • 既存のイベントを更新または削除します。
    • スケジュール用の空き時間枠を見つけます。
  • ドライブ:
    • 検索クエリでフィルタリング
    • 変更日やその他の基準で並べ替える
    • 表示数をカスタマイズする
    • 詳細なファイルメタデータを表示する
    • ファイルの内容(テキスト、ドキュメント、スプレッドシート)を読み取る
    • 指定した内容で新しいファイルを作成する
    • 既存のファイルを更新する
    • ファイルを削除する(ゴミ箱または永久)
    • 特定の権限でファイルを共有する
  • タスク:
    • すべてのタスクリストを表示
    • 新しいタスクリストを作成する
    • 既存のタスクリストを削除する
    • デフォルトのタスクリストを設定する
    • フィルターを使用してタスクを一覧表示する
    • タスクの詳細を表示
    • タイトル、メモ、期限付きのタスクを作成する
    • タスクのプロパティを更新する
    • タスクを完了としてマークする
    • タスクを削除する
  • TODO計画:
    • Google 連絡先: 連絡先を検索および管理します。
    • その他にも多数...

ワークフローのコマンドを連鎖することができます。例:

「未読メールをリストし、最新のメールへの返信を下書きし、明日午後 2 時にフォローアップ ミーティングをスケジュールします。」

手動インストール

  1. 前提条件:
    • Bunをインストールします:
    brew install oven-sh/bun/bun # macOS/Linux with Homebrew
  2. OAuth の設定:
    • Google Cloud Consoleで Google Cloud プロジェクトを作成します。
    • OAuth 2.0 資格情報 (クライアント ID、クライアント シークレット) を設定します。
    • デスクトップ アプリの種類を選択します。
    • テスト モードを使用する場合は、テスト ユーザー リストにメールを追加します。
    • 必要なサービス (Gmail、カレンダー、ドライブなど) への API アクセスが有効になっていることを確認してください。
  3. クライアントを構成する: claude_desktop_config.json (またはクライアントの同等の構成ファイル) を編集します。
{ "mcpServers": { "google-mcp": { "command": "bunx", "args": ["--no-cache", "google-mcp@latest"], "env": { // Either can be used, but not both // Use OAuth "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>", "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>", // Use Service Account "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>", "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>", "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>" } } } }
  1. 認証:
    • サーバーを初めて起動すると、OAuth認証用のブラウザが開きます。プロンプトに従ってアクセスを許可すると、トークンがGOOGLE_OAUTH_TOKEN_PATHに保存されます。

使用法

ここで、Claude にgoogle-mcpツールを使用するように依頼します。

Send an email to jane.doe@example.com with the subject "Meeting Notes" and body "Here are the notes from today."
List my upcoming calendar events for the next 3 days.
Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.

地域開発

git clone https://github.com/vakharwalad23/google-mcp.git cd google-mcp bun install bun run index.ts

Google MCP ツールをご利用いただきありがとうございます。ご質問やご提案がございましたら、お気軽に問題を報告したり、プロジェクトにご協力ください。

ツールをいろいろ試して楽しんでください!!

-
security - not tested
-
license - not tested
-
quality - not tested

これは、MCP プロトコル用の Google ネイティブ ツール (Gmail、カレンダーなど) のコレクションであり、Claude や Cursor などの AI クライアントとシームレスに統合できるように設計されています。

  1. Features
    1. Manual Installation
  2. Usage
    1. Local Development
      ID: opwf6bop3j