Gmail MCP Server 3

🚀 グーグルワークスペース MCP サーバー

このサーバーは、Model Context Protocol (MCP) を介して、Gmail とカレンダー API との相互作用を可能にするツールを提供します。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：
   • プロジェクトを作成し、Gmail API と Calendar API を有効にします。
   • プロジェクトに OAuth クライアント ID を作成し、client_id、client_secret、refresh_token を取得します。
3. 環境変数：サーバー環境に以下の変数を設定します。

   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REFRESH_TOKEN=your_refresh_token
   

セットアップ手順

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

   git clone https://github.com/yourusername/google-workspace-mcp.git
   cd google-workspace-mcp
   

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

   npm install
   

3. 認証情報ファイルを作成する：
   • プロジェクトのルートディレクトリに credentials.json ファイルを作成し、以下の内容を記述します。

     {
       "client_id": "your_client_id",
       "client_secret": "your_client_secret",
       "refresh_token": "your_refresh_token"
     }
     

4. サーバーを起動する：

   node index.js
   

💻 使用例

メール操作

基本的な使用法

// メールをリストする
{
  "action": "list_emails",
  "params": {
    "limit": 10,
    "folder": "inbox"
  }
}

高度な使用法

// メールを送信する
{
  "action": "send_email",
  "params": {
    "to": "recipient@example.com",
    "subject": "Test Email",
    "body": "This is a test email."
  }
}

カレンダー操作

基本的な使用法

// イベントを作成する
{
  "action": "create_event",
  "params": {
    "summary": "会議のリマインダー",
    "location": "会議室 101",
    "description": "毎週の同期会議",
    "start": "2024-01-24T10:00:00Z",
    "end": "2024-01-24T11:00:00Z",
    "attendees": ["colleague@example.com"]
  }
}

高度な使用法

// イベントを更新する
{
  "action": "update_event",
  "params": {
    "event_id": "event_id_to_update",
    "summary": "更新された会議のタイトル",
    "location": "オンライン会議"
  }
}

📚 ドキュメント

トラブルシューティング

認証問題

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

API エラー

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

📄 ライセンス

このプロジェクトは MIT License の下でオープンソース化されています。