py-mcp-google-toolbox

AI アシスタントに、Gmail、Google カレンダー、Google ドライブ、Google 検索などの Google サービスとやり取りするための強力なツールを提供する MCP サーバー。

概要

py-mcp-google-toolbox は、次の Google 関連機能を提供します。

• Gmail の操作（読み取り、検索、送信、変更）

• Google カレンダーの管理（イベントの作成、一覧表示、更新、削除）

• Google ドライブの操作（検索、ファイルの読み取り）

• Google 検索統合（ウェブ検索）

目次

• 前提条件

• インストール

• MCP設定を構成する

• ツールドキュメント

  • Gmailツール

  • カレンダーツール

  • ドライブツール

  • 検索ツール

• 発達

• ライセンス

前提条件

1. Python : Python 3.12以降をインストールします

2. Google Cloud Console のセットアップ:

   • Google Cloud Consoleに移動

   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください

   • サービス API を有効にします。

     1. 「APIとサービス」>「ライブラリ」に移動します

     2. 「Gmail API」を検索して有効にします

     3. 「Google カレンダー API」を検索して有効にします

     4. 「Google Drive API」を検索して有効にします

     5. 検索フォームで「カスタム検索API」を有効にする

   • GCP から OAuth 2.0 認証情報を設定します。

     1. 「APIとサービス」>「認証情報」に移動します

     2. 「認証情報を作成」>「OAuthクライアントID」をクリックします

     3. 「Webアプリケーション」を選択

     4. クライアントIDとクライアントシークレットを書き留めます

        • クライアントID

        • クライアントシークレット

     5. secret json をダウンロードし、credentials.json に名前を変更します。

   • APIキーを生成する

3. カスタム検索エンジンにアクセスしてIDを取得します

インストール

Gitクローン

構成

1. UV パッケージ マネージャーをインストールします。

2. 仮想環境を作成してアクティブ化します。

3. 依存関係をインストールします:

4. リフレッシュトークンを取得します（トークンの有効期限が切れている場合はこれを実行できます）

これにより、次のようになります。

• Google OAuth認証のためにブラウザを開きます

• 次の権限を要求します。

  • https://www.googleapis.com/auth/gmail.modify

  • https://www.googleapis.com/auth/calendar

  • https://www.googleapis.com/auth/gmail.send

  • https://www.googleapis.com/auth/gmail.readonly

  • https://www.googleapis.com/auth/drive

  • https://www.googleapis.com/auth/drive.file

  • https://www.googleapis.com/auth/drive.readonly

• 資格情報をtoken.jsonに保存します

• コンソールにリフレッシュトークンを表示する

5. 環境変数:

6. credentials.json をプロジェクトのルートフォルダにコピーします (py-mcp-google-toolbox)

Dockerの使用

1. Docker イメージをビルドします。

2. コンテナを実行します。

ローカルの使用

1. サーバーを実行します。

MCP設定を構成する

MCP 設定ファイルにサーバー構成を追加します。

クロードデスクトップアプリ

1. Smithery経由で自動的にインストールするには:

2. 手動でインストールするには~/Library/Application Support/Claude/claude_desktop_config.jsonを開きます。

これをmcpServersオブジェクトに追加します。

カーソルIDE

~/.cursor/mcp.jsonを開く

これをmcpServersオブジェクトに追加します。

Docker用

ツールドキュメント

Gmailツール

• list_emails : Gmailの受信トレイからフィルタリングオプション付きで最近のメールを一覧表示します

• search_emails : 詳細なメール内容の取得を伴う高度な Gmail 検索を実行します

• send_email : CC、BCC 受信者をサポートしてメールを作成して送信します

• modify_email : ラベルを変更してメールの状態（既読/未読、アーカイブ、ゴミ箱）を変更します

カレンダーツール

• list_events : 指定された時間範囲内の今後のカレンダーイベントを取得します。

• create_event : 出席者、場所、説明を含む新しいカレンダーイベントを作成します

• update_event : 柔軟なパラメータ更新で既存のカレンダーイベントを変更します

• delete_event : イベントIDでカレンダーイベントを削除します

ドライブツール

• read_gdrive_file : Google ドライブのファイルからコンテンツを読み取り、取得します

• search_gdrive : カスタマイズ可能なクエリを使用して Google ドライブ内のファイルを検索します

検索ツール

• search_google : Google検索を実行し、フォーマットされた結果を返します

発達

ローカルテストの場合は、付属のクライアント スクリプトを使用できます。

ライセンス

MITライセンス