mcp-gsuite-enhanced

mcp-gsuite-enhanced

Gmail API を完全にカバーし、高度なメール管理機能を備えた Google Workspace 向け包括的 MCP サーバー

Google 製品と連携する MCP サーバーです。Gmail API を完全にカバー（合計 27 個のツール）し、高度なメール管理、ラベル操作、アーカイブのワークフロー、動作する Google Meet 連携を提供します。

目次

• クイックスタート
• 拡張機能
• 機能と能力
• プロンプトの例
• インストール
• Google 認証のセットアップ
• 設定例
• Google Meet 連携
• 開発
• セキュリティ
• クレジット
• ライセンス
• コントリビューション
• サポート

🚀 クイックスタート

5 分で Google Workspace MCP を使い始めましょう！

前提条件

• Python 3.13 以降と uv がインストールされていること
• Gmail／Calendar にアクセスできる Google アカウント
• Cursor IDE（推奨）または任意の MCP クライアント

ステップ 1：クローンしてインストール

git clone https://github.com/ajramos/mcp-gsuite-enhanced.git
cd mcp-gsuite-enhanced
uv sync

ステップ 2：Google Cloud をセットアップ（初回のみ）

1. Google Cloud Console にアクセスします
2. プロジェクトを作成し、Gmail API と Google Calendar API を有効にします
3. OAuth 2.0 Desktop 認証情報を作成します
4. ダウンロードし、プロジェクトディレクトリに .gauth.json として保存します

ステップ 3：アカウントを設定

.accounts.json を作成します：

{
  "accounts": [
    {
      "email": "[email protected]",
      "account_type": "personal", 
      "extra_info": "Main personal Gmail and Calendar"
    }
  ]
}

ステップ 4：簡単な設定確認

python cursor_setup.py

認証ステータスを表示し、Cursor の設定を生成します。

ステップ 5：認証

python auth_setup.py [email protected]

OAuth の手続きのためにブラウザーが開きます。権限を許可すれば完了です！

ステップ 6：Cursor で設定

1. ステップ 4 の JSON 設定をコピーします
2. Cursor → Settings（Cmd+,）→「MCP」を検索します
3. 設定を貼り付けて、Cursor を再起動します

ステップ 7：テストしましょう！🎉

Cursor で次のコマンドを試してください：

• 「自分のカレンダーを一覧表示して」
• 「未読メールを表示して」
• 「Google Meet のリンク付きテスト会議を作成して」

これで完了です！ Google Meet のリンクが自動生成される、Google Workspace との完全な連携を利用できます！

---

🎯 拡張機能 v2.0.0

🚀 Gmail API を完全にカバー（ツール合計 27 個）

• Gmail ツール 22 個 - メールのライフサイクルを完全に管理
• Calendar ツール 5 個 - Google Meet との完全なカレンダー連携

✨ 高度なメール管理

• ✅ メール送信 - Gmail から直接メールを送信
• ✅ ラベル管理 - ラベルの作成、適用、削除、解除
• ✅ アーカイブのワークフロー - メールのアーカイブ、復元、ライフサイクル管理
• ✅ 下書き管理 - メールの下書きの一覧表示、作成、管理
• ✅ 一括操作 - 複数のメールを効率的にアーカイブ
• ✅ メールのステータス - 既読／未読に設定、ゴミ箱へ移動

🎪 拡張されたカレンダー機能

• ✅ 動作する Google Meet 連携 - カレンダーの予定に Meet リンクを自動追加
• ✅ update_calendar_event を修正 - 以前は動作しませんでしたが、現在は完全に機能します
• ✅ 参加者処理を改善 - メール解析のバグを修正
• ✅ セットアップユーティリティ - 簡単に設定できる auth_setup.py と cursor_setup.py

機能と能力

v2.0.0 は、合計 27 個のツールによる包括的な Google Workspace 自動化を提供します：

1. 一般

• 複数の Google アカウントをサポート
• トークンの更新に対応した OAuth 2.0 認証
• 包括的なエラー処理とログ記録

2. Gmail（22 個のツール）📧

メール管理

• CC／BCC に対応し、Gmail からメールを直接送信
• 未読、送信者、日付、添付ファイルなど、柔軟な検索条件でメールを検索
• ID を指定してメールの全文を取得、または複数のメールを一度に取得
• メールを既読／未読にする
• メールをゴミ箱に移動

下書き管理

• 宛先、件名、本文、CC を指定して新しいメールの下書きを作成
• 詳細情報付きですべてのメールの下書きを一覧表示
• メールの下書きを削除
• 既存のメールに返信（すぐに送信、または下書きとして保存）

ラベル管理 🏷️

• すべての Gmail ラベル（システムラベル＋カスタムラベル）を一覧表示
• 新しいカスタムラベルを作成
• メールにラベルを付ける
• メールからラベルを削除
• カスタムラベルを完全に削除

アーカイブのワークフロー 📁

• 個々のメールをアーカイブ（受信トレイから削除）
• 複数のメールを一度にアーカイブ（一括操作）
• アーカイブ済みメールを一覧表示
• アーカイブ済みメールを受信トレイに復元

添付ファイル管理

• メールの添付ファイルをダウンロードしてローカルファイルに保存
• 複数のメールから添付ファイルを一括保存

3. Calendar（5 個のツール）📅

• アカウントで利用可能なカレンダーを一覧表示
• 指定した期間内のカレンダーイベントを取得
• 参加者とGoogle Meet リンクの自動生成 🎪に対応した新しいカレンダーイベントを作成
• 既存のカレンダーイベントを更新（概要、時間、参加者）⚡
• カレンダーイベントを削除
• 海外とのスケジュール調整に対応した完全なタイムゾーンサポート

💡 試してみたいプロンプト

📧 Gmail の操作（22 個のツール）

• メールの検索と取得

  • 「最新の未読メッセージを取得して」
  • 「スクラムマスターからのメールを検索して」
  • 「今週、添付ファイル付きで届いたメールをすべて表示して」
  • 「ABC に関するメールを取得して要約して」

• メールの作成と管理

  • 「プロジェクトの進捗について、[email protected] にメールを送信して」
  • 「Alice からの最新メールへの丁寧な返信を書いて、下書きとして保存して」
  • 「[email protected] からのメールをすべて既読にして」
  • 「あの迷惑メールをゴミ箱に移動して」

• ラベル管理 🏷️

  • 「『Project Alpha』というラベルを作成して、プロジェクトに関するメールに付けて」
  • 「カスタムラベルをすべて表示して」
  • 「昨日のメールから『Urgent』ラベルを削除して」
  • 「使っていない『Old Project』ラベルを削除して」

• アーカイブのワークフロー 📁

  • 「先週のニュースレターからのメールをすべてアーカイブして」
  • 「第 3 四半期のアーカイブ済みメールを表示して」
  • 「あの重要なメールを受信トレイに復元して」
  • 「次の 5 件のメールを一度にアーカイブして：[email IDs]」

• 添付ファイル管理

  • 「『invoice』を含むメールから添付ファイルをすべてダウンロードして」
  • 「今週 [email protected] から届いたすべてのメールの添付ファイルを保存して」

📅 カレンダー管理

• 予定とスケジュール調整

  • 「明日の予定は何？」
  • 「来週の個人アカウントの Family カレンダーを確認して」
  • 「来週、Tim と 2 時間のイベントを計画したい。空いている時間帯をいくつか提案して」

• Google Meet を使ったイベントの作成 🎪

  • 「来週の金曜日に John とのミーティングを作成して、Google Meet のリンクを含めて」
  • 「木曜日の午後 2 時にクライアントとの通話を予定して、[email protected] を招待して」
  • 「毎週月曜日の午前 9 時に Google Meet を使ったチームの朝会を作成して」
  • 「明日の午後 3 時に、Google Meet のリンクを付けてチーム全員を招待し、プロジェクトレビューのミーティングを作成して」

• イベントの更新 ⚡ (強化機能)

  • 「午後 3 時のミーティングに Sarah を参加者として追加して」
  • 「四半期計画のミーティングの時間を午後 4 時に変更して、[email protected] を追加して」
  • 「明日のチームミーティングの場所を Conference Room B に変更して」

• 高度なカレンダー検索

  • 「来週のカレンダーイベントのうち、Google Meet のリンクがあるものをすべて一覧表示して」
  • 「今月の定期ミーティングをすべて表示して」
  • 「来週予定されている、社外の参加者がいるミーティングをすべて探して」

インストール

オプション 1：Smithery からのクイックインストール（推奨）📦

MCP GSuite Enhanced をすぐに使い始める最速の方法です。

npx -y @smithery/cli install mcp-gsuite-enhanced --client claude

これにより、次の処理が自動的に行われます。

• ✅ 最新バージョンをダウンロードしてインストールします
• ✅ Claude Desktop を設定します
• ✅ MCP サーバーのエントリをセットアップします

オプション 2：手動インストール 🔧

上級ユーザーや開発目的の場合に適しています。

Cursor IDE のセットアップ

Cursor IDE ユーザーは、セットアップヘルパースクリプトを使用してください。

python cursor_setup.py

このスクリプトは適切な MCP 設定を生成し、Cursor の設定に追加する手順を順を追って案内します。

uv を使用した手動インストール（推奨）

git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
uv sync

pip を使用した手動インストール

git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
pip install -e .

Google 認証のセットアップ

Google Cloud の設定

Google Cloud プロジェクトを作成し、OAuth2 認証情報を設定する必要があります。

ステップ 1：Google Cloud プロジェクトを作成する

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. 必要な API を有効にします。
   • 「APIs & Services」→「Library」に移動します
   • **「Gmail API」**を検索して有効にします
   • **「Google Calendar API」**を検索して有効にします

ステップ 2：OAuth 2.0 認証情報をセットアップする

1. 「APIs & Services」→「Credentials」に移動します
2. 「Create Credentials」→「OAuth client ID」をクリックします
3. アプリケーションの種類として**「Desktop application」**を選択します
4. 求められた場合は、OAuth 同意画面を設定します
5. 認証情報の JSON ファイルをダウンロードし、プロジェクトディレクトリに .gauth.json として保存します

ステップ 3：Google アカウントを設定する

使用する Google アカウントを指定するため、プロジェクトディレクトリに .accounts.json ファイルを作成します。

{
  "accounts": [
    {
      "email": "[email protected]",
      "account_type": "work",
      "extra_info": "Work account with company calendar"
    },
    {
      "email": "[email protected]", 
      "account_type": "personal",
      "extra_info": "Personal account with family calendar"
    }
  ]
}

フィールドの説明：

• email：Google アカウントのメールアドレス
• account_type：「仕事用」、「個人用」などのカテゴリです（整理に役立ちます）
• extra_info：このアカウントの目的を AI が理解するための追加情報です

ステップ 4：Google アカウントを認証する

.gauth.json と .accounts.json の両方のファイルを用意したら、各アカウントの認証セットアップを実行します。

python auth_setup.py [email protected]
python auth_setup.py [email protected]

このスクリプトは OAuth フローを自動的に処理し、認証情報を .oauth2.{email}.json ファイルに安全に保存します。

⚠️ セキュリティに関する警告：認証情報ファイル（.gauth.json、.accounts.json、.oauth2.*.json）をバージョン管理にコミットしないでください。機密性の高い認証データが誤って公開されないよう、.gitignore ファイルに追加してください。

OAuth 2.0 スコープ（自動）

サーバーは次の権限を自動的にリクエストします。手動での設定は不要です。

[
  "openid",
  "https://www.googleapis.com/auth/userinfo.email",
  "https://mail.google.com/",
  "https://www.googleapis.com/auth/calendar"
]

これらのスコープにより、サーバーは次の操作が可能になります。

• ✅ Gmail へのアクセス（読み取り、送信、下書きの管理）
• ✅ Google Calendar の管理（予定の作成、更新、削除）
• ✅ Google Meet のリンクの自動作成
• ✅ Google アカウントの識別

設定例

Claude Desktop（拡張バージョン）

これを Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "mcp-gsuite-enhanced": {
      "command": "uv",
      "args": [
        "--directory", 
        "/path/to/mcp-gsuite-enhanced",
        "run",
        "mcp-gsuite-enhanced"
      ]
    }
  }
}

Claude Desktop（Smithery インストール）

Smithery 経由でインストールした場合、設定は自動的に行われます。手動でのセットアップは不要です。

uvx を使用する場合（拡張バージョン）

{
  "mcpServers": {
    "mcp-gsuite-enhanced": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-gsuite-enhanced",
        "run",
        "mcp-gsuite-enhanced"
      ]
    }
  }
}

Google Meet の拡張統合

拡張バージョンでは、新しいカレンダー予定の Google Meet リンクが自動的に作成されます。

{
  "calendar_id": "primary",
  "summary": "Team Standup",
  "start_time": "2024-01-15T10:00:00Z",
  "end_time": "2024-01-15T10:30:00Z",
  "attendees": "[email protected],[email protected]",
  "create_meet_link": true
}

これにより、次の内容を含むカレンダー予定が作成されます。

• ✅ Google Meet リンクの自動作成
• ✅ 電話によるダイヤルイン番号
• ✅ 会議 PIN
• ✅ すべての参加者への招待

開発

開発環境をセットアップするには、次を実行します。

git clone https://github.com/ajramos/mcp-gsuite-enhanced
cd mcp-gsuite-enhanced
uv sync
uv run mcp-gsuite-enhanced

MCP Inspector を使用したデバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ環境を利用するには、MCP Inspector の使用を強くおすすめします。

次のコマンドを使用して、npm 経由で MCP Inspector を起動できます。

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

起動すると、Inspector に URL が表示されます。この URL にブラウザーからアクセスして、デバッグを開始できます。

サーバーログ

次のコマンドを使用して、サーバーログを確認することもできます。

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

# Linux 
tail -n 20 -f ~/.config/Claude/logs/mcp-server-mcp-gsuite-enhanced.log

# Windows
Get-Content "$env:APPDATA\Claude\logs\mcp-server-mcp-gsuite-enhanced.log" -Wait -Tail 20

セキュリティ

• すべての認証は OAuth 2.0 を使用してローカルで処理されます
• 認証情報はローカルファイルに安全に保存されます
• Google の API 以外の第三者にデータが送信されることはありません
• 認証情報を分離した状態で、複数の Google アカウントをサポートします

クレジット

Markus Pfundstein による mcp-gsuite をベースにしています。

Angel Ramos により、Gmail API の包括的な対応、Google Meet の統合、機能の改善が行われています。

謝辞

• 元のプロジェクト：mcp-gsuite、Markus Pfundstein による（MIT License）
• Gmail の機能は、Gmail-MCP-server を含むコミュニティによる MCP 実装に着想を得ています
• すべてのコードは、Google API の公式ドキュメントを使用して独自に実装されています
• MIT ライセンスの下でライセンスされており、GPL コードは組み込まれていません

ライセンス

MIT License です。詳細は LICENSE ファイルをご覧ください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

サポート

拡張機能で問題が発生した場合：

1. 上記のデバッグ手順を使用してログを確認します
2. python auth_setup.py <your-email> を実行して認証を確認します
3. 以下の情報を添えてIssue を作成します：
   • 使用しているオペレーティングシステム
   • Python のバージョン
   • エラーメッセージまたはログ
   • 問題を再現する手順

一般的な MCP に関する質問については、Model Context Protocol のドキュメントをご覧ください。