Epaproditus Google Workspace MCP Server

🚀 Google 工作区 MCP サーバー

このサーバーは、Model Context Protocol (MCP) を介して、Gmail とカレンダー API とのやり取りを可能にするツールを提供します。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 Workspace API と Calendar API を有効にします。
   • OAuth 2.0 の認証情報を設定し、以下のスコープを許可します。 https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/calendar

設定手順

1. リポジトリをクローンする：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 依存関係をインストールする：

   npm install
   

3. 認証情報ファイルを作成する：
   • Google Cloud Console で credentials.json ファイルを作成し、以下のような内容にします。

     {
       "type": "service_account",
       "project_id": "your-project-id",
       "private_key_id": "your-private-key-id",
       "client_email": "your-service-account@your-project-id.iam.gserviceaccount.com",
       "private_key": "your-private-key",
       "client_id": "your-client-id",
       "auth_uri": "https://accounts.google.com/o/oauth2/auth",
       "token_uri": "https://oauth2.googleapis.com/token",
       "AuthProviderLink": "https://www.googleapis.com/auth/",
       "Authority": "https://accounts.google.com/o/oauth2/auth"
     }
     

4. リフレッシュトークンを取得する：

   npm run get-refresh-token
   

MCP 設定の構成

1. 以下のパスに従って、異なる IDE の MCP 設定を構成します。
   • VS Code：~/.config/google/workspace-mcp/setting.json
   • IntelliJ IDEA：File > Settings > Google Workspace MCP Config
   • PyCharm：File > Settings > Google Workspace MCP Config
2. 設定内容の例：

   {
     "gmail": {
       "apiKey": "your-gmail-api-key",
       "refreshToken": "your-refresh-token"
     },
     "calendar": {
       "apiKey": "your-calendar-api-key",
       "refreshToken": "your-refresh-token"
     }
   }
   

ビルドと実行

npm run build
npm start

💻 使用例

Gmail の使用例

基本的な使用法

{
  "command": "list_emails",
  "maxResults": 10,
  "q": "subject:meeting"
}

高度な使用法

{
  "command": "send_email",
  "to": "recipient@example.com",
  "subject": "テストメール",
  "body": "これはテストメールの内容です。"
}

カレンダーの使用例

基本的な使用法

{
  "command": "create_event",
  "summary": "チーム会議",
  "location": "会議室",
  "description": "毎週の同期会",
  "start": "2024-01-24T10:00:00Z",
  "end": "2024-01-24T11:00:00Z",
  "attendees": ["colleague@example.com"]
}

📚 ドキュメント

トラブルシューティング

認証問題

• すべての必須 OAuth スコープが承認されていることを確認してください。
• クライアント ID とシークレットが正しいことを検証してください。
• リフレッシュトークンの有効性を確認してください。

API エラー

• Google Cloud Console で API のクォータと制限を確認してください。
• プロジェクトで APIs が有効になっていることを確認してください。
• リクエストパラメータが要求される形式に合致していることを検証してください。

📄 ライセンス

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