Gmail & Google Calendar

🚀 mcp-gsuite MCP サーバ

Google 製品と相互作用する MCP サーバです。

🚀 クイックスタート

この MCP サーバは Google 製品とのインタラクションを可能にし、現在は Gmail とカレンダーの統合をサポートしています。

✨ 主な機能

示例提示

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

1. 汎用機能

• 複数の Google アカウント

2. Gmail

• Gmail ユーザー情報の取得
• 柔軟な検索クエリでのメール取得（例：未読メール、特定の送信者からのメール、日付範囲、添付ファイル付きのメール）
• ID で完全なメール内容を検索
• 受信者、件名、本文、添付ファイルをサポートする新しい下書きメールの作成
• メールの送信
• メールの削除

3. カレンダー

• Google カレンダーのすべてのイベントを取得
• 新しいカレンダーイベントの作成
• 既存のカレンダーイベントの更新
• カレンダーイベントの削除

📦 インストール

配置オプション

MCP サーバは、コマンドライン引数でカスタムパスを指定することで、認証とアカウント情報を管理できます。

• --gauth-file：OAuth2 クライアント構成を含む .gauth.json ファイルのパスを指定します。デフォルトは現在のディレクトリです。
• --accounts-file：Google アカウント情報を含む .accounts.json ファイルのパスを指定します。デフォルトは現在のディレクトリです。
• --credentials-dir：認証資格情報を保存するディレクトリを指定します。デフォルトは現在のディレクトリで、各アカウントは .oauth.{email}.json として個別に保存されます。

示例コマンド：

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

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

💻 使用例

基本的な使用法

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

🔧 技術詳細

開発

構築と公開

リリースバージョンを準備するには：

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