Gsuite MCP

🚀 Google 工作区 MCP サーバー

Google 工作区 MCP サーバーは、Gmail とカレンダー API ツールを提供する Model Context Protocol (MCP) サーバーです。MCP インターフェースを通じて、電子メールとカレンダーイベントをプログラムで管理することができます。

🚀 クイックスタート

このサーバーを使用することで、Gmail とカレンダーの操作をプログラムで行うことが可能になります。以下のセクションでは、機能、インストール方法、使用例などを詳しく説明します。

✨ 主な機能

メールツール

• list_emails：受信トレイ内の最近のメールをリスト表示し、必要に応じてフィルタリングできます。
• search_emails：Gmail のクエリ構文を使用した高度なメール検索が可能です。
• send_email：新しいメールを送信し、CC と BCC をサポートします。
• modify_email：メールのラベルを変更（アーカイブ、削除、既読/未読としてマーク）できます。

カレンダーツール

• list_events：予定されているカレンダーイベントをリスト表示し、必要に応じて日付範囲でフィルタリングできます。
• create_event：新しいカレンダーイベントを作成し、参加者を追加できます。
• update_event：既存のカレンダーイベントを更新します。
• delete_event：カレンダーイベントを削除します。

📦 インストール

前提条件

1. Node.js：Node.js 14 以上のバージョンをインストールしてください。
2. Google Cloud Console の設定：
   • Google Cloud Console にアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • Gmail API と Google Calendar API を有効にします。
     1. "APIs & Services" > "Library" に移動します。
     2. "Gmail API" を検索して有効にします。
     3. "Google Calendar API" を検索して有効にします。
   • OAuth 2.0 の認証情報を設定します。
     1. "APIs & Services" > "Credentials" に移動します。
     2. "Create Credentials" > "OAuth client ID" をクリックします。
     3. "Web アプリケーション" を選択します。
     4. "Authorized redirect URIs" に http://localhost:4100/code を設定します。
     5. Client ID と Client Secret をメモしておきます。

Smithery を使用した自動インストール

Smithery を通じて自動インストールするには、次のコマンドを実行します。

$ npm install -g @rishipradeep-think41/gsuite-mcp

手動インストール

最新バージョンの MCP サーバーを手動でダウンロードしてインストールするには、以下の手順を実行します。

1. latest.mcp をダウンロードします。
2. ファイルを目的のディレクトリに解凍します。
3. start_server.sh または start_server.bat を実行してサーバーを起動します。

💻 使用例

基本的な使用法

メール操作の例

{
  "command": "list_emails",
  "params": {
    "label": "INBOX",
    "maxResults": 10
  }
}

カレンダー操作の例

{
  "command": "create_event",
  "params": {
    "summary": "会議",
    "location": "会議室 A",
    "start_time": "2024-01-24T10:00:00Z",
    "end_time": "2024-01-24T11:00:00Z"
  }
}

📚 ドキュメント

トラブルシューティング

1. 認証問題：
   • すべての必要な OAuth スコープが付与されていることを確認してください。
   • クライアント ID とシークレットが正しいことを検証してください。
   • リフレッシュトークンが有効であることを確認してください。
2. API エラー：
   • Google Cloud Console で API のクォータと制限を確認してください。
   • API があなたのプロジェクトで有効になっていることを確認してください。
   • リクエストパラメータが必要な形式に従っていることを検証してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。