MCP Gsuite

🚀 mcp-gsuite MCPサーバー

Google製品とのインタラクションを可能にするMCPサーバーです。

🚀 クイックスタート

このMCPサーバーは、Gmailとカレンダーの統合をサポートしており、Google製品とのインタラクションを容易にします。

✨ 主な機能

サポート機能

現在、このMCPサーバーはGmailとカレンダーの統合をサポートしており、以下の機能を備えています。

1. 汎用

• 複数のGoogleアカウントをサポート

2. Gmail

• Gmailのユーザー情報を取得
• 柔軟な検索クエリでメールを検索（未読、特定の送信者からのメール、日付範囲、添付ファイル付きなど）
• IDに基づいて完全なメール内容を取得
• 受信者、件名、本文、CCオプションを含む新しい下書きメールを作成
• 下書きメールを削除
• 既存のメールに返信（即時送信または下書きとして保存）
• IDに基づいて複数のメールを一度に取得
• メールから複数の添付ファイルをローカルシステムに保存

3. カレンダー

• 複数のカレンダーを管理
• 指定された時間範囲内のカレンダーイベントを取得
• 開始時間、終了時間、タイトル、場所、説明を含むカレンダーイベントを作成
• 既存のイベントを更新または新しいイベントを作成（繰り返しの場合）
• すべての現在のユーザーのGoogleカレンダーを取得
• IDに基づいて単一のイベントを取得
• イベントを削除

📦 インストール

MCPサーバーは、コマンドラインオプションを使用して、認証とアカウント情報のカスタムパスを指定することで構成できます。

• --gauth-file：OAuth2クライアント構成を含む.gauth.jsonファイルのパスを指定します。デフォルトは./.gauth.jsonです。
• --accounts-file：Googleアカウント情報を含む.accounts.jsonファイルのパスを指定します。デフォルトは./.accounts.jsonです。
• --credentials-dir：認証成功後にOAuth資格情報を保存するディレクトリを指定します。デフォルトは現在の作業ディレクトリで、各アカウントは.oauth.{email}.jsonというサブディレクトリを使用します。

これらのオプションは、開発やテストシナリオで、特に複数の環境や異なる構成セットを管理する必要がある場合に非常に便利です。

📚 ドキュメント

ビルドとリリース

パッケージを配布する準備をします。

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージの配布用ビルドを行います。

uv build

これにより、dist/ディレクトリにソースコードとバイナリ配布物が作成されます。

3. PyPIに公開します。

uv publish

注意：PyPIの資格情報は、環境変数またはコマンドラインフラグを使用して設定する必要があります。

• トークン：--tokenまたはUV_PUBLISH_TOKEN
• またはユーザー名/パスワード：--username/UV_PUBLISH_USERNAMEおよび--password/UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーは標準入出力で動作するため、デバッグは難しい場合があります。最適なデバッグ体験を得るために、MCP Inspectorの使用を強くおすすめします。

以下のコマンドでMCP Inspectorを起動できます。

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

起動後、InspectorはブラウザでアクセスできるURLを表示し、デバッグを開始できます。

また、以下のコマンドでサーバーのログを表示できます。

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log