Gmail MCP Server

Gmail MCP サーバー

imap-mcp-server は Gmail 専用に設計されており、Gmail アカウント向けに AI を活用した分析および管理機能を提供します。Gmail API を利用することで、シームレスな統合と高度な機能を実現します。

機能

• Gmail 専用の統合：Gmail API を使用し、Gmail アカウント専用に構築されています。
• AI を活用した分析：メールのパターンを分析し、メッセージに優先順位を付け、Gmail の受信トレイに関するインサイトを得られます。
• スマートフォルダー管理：Gmail 用のカスタムフィルタールールを設定して、スマートフォルダーを作成および管理できます。
• Google Cloud Storage との統合：Gmail のメッセージや添付ファイルを Google Cloud Storage に移行して保存できます。
• バッチ処理：カスタム条件に基づいて、Gmail のメッセージに一括操作を実行できます。

MCP サーバーの設定

このサーバーを VS Code の MCP（Model Context Protocol）機能で使用するには、次の設定を VS Code の settings.json に追加してください。

"mcp": {
  "inputs": [
    {
      "type": "promptString",
      "id": "gmail-username",
      "description": "Gmail Username"
    },
    {
      "type": "promptString",
      "id": "gmail-password",
      "description": "Gmail Password",
      "password": true
    },
    {
      "type": "promptString",
      "id": "gemini-key",
      "description": "Gemini API Key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "gcs-credentials",
      "description": "Google Cloud Service Account JSON",
      "password": true
    }
  ],
  "servers": {
    "imap-mcp": {
      "type": "stdio",
      "command": "${userHome}/git/imap-mcp-server/venv/bin/python",
      "args": [
        "${userHome}/git/imap-mcp-server/src/server.py"
      ],
      "env": {
        "GEMINI_API_KEY": "${input:gemini-key}",
        "IMAP_HOST": "imap.gmail.com",
        "ANALYTICS_BATCH_SIZE": "50",
        "ANALYTICS_CACHE_DURATION": "60",
        "ANALYTICS_THREAD_ANALYSIS": "true",
        "ANALYTICS_PRIORITY_SCORING": "true",
        "GCS_BUCKET": "imap-mcp-server",
        "ANALYTICS_SENDER_THRESHOLD": "7",
        "ANALYTICS_DOMAIN_THRESHOLD": "10",
        "ANALYTICS_UPDATE_INTERVAL": "3600",
        "ANALYTICS_LABEL_TRACKING": "true",
        "ANALYTICS_TYPE_CLASSIFICATION": "true",
        "LOG_LEVEL": "ERROR"
      }
    }
  }
}

設定オプション

• 環境変数：
  • GEMINI_API_KEY：AI を活用した分析に使用する Gemini API キー
  • IMAP_HOST：Gmail IMAP サーバー（デフォルト：imap.gmail.com）
  • ANALYTICS_BATCH_SIZE：各バッチで処理するメールの件数（デフォルト：50）
  • ANALYTICS_CACHE_DURATION：キャッシュの有効期間（分）（デフォルト：60）
  • ANALYTICS_THREAD_ANALYSIS：スレッド分析を有効にするかどうか（デフォルト：true）
  • ANALYTICS_PRIORITY_SCORING：メールの優先度スコア付けを有効にするかどうか（デフォルト：true）
  • GCS_BUCKET：メールの保存先となる Google Cloud Storage バケット名
  • ANALYTICS_SENDER_THRESHOLD：分析を開始する送信者ごとの最小メール件数（デフォルト：7）
  • ANALYTICS_DOMAIN_THRESHOLD：分析を開始するドメインごとの最小メール件数（デフォルト：10）
  • ANALYTICS_UPDATE_INTERVAL：分析の更新間隔（秒）（デフォルト：3600）
  • ANALYTICS_LABEL_TRACKING：ラベルの追跡を有効にするかどうか（デフォルト：true）
  • ANALYTICS_TYPE_CLASSIFICATION：メールの種類の分類を有効にするかどうか（デフォルト：true）
  • LOG_LEVEL：ログレベル（デフォルト：ERROR）

前提条件

サーバーを使用する前に、以下を行ってください。

1. プロジェクトディレクトリに Python 仮想環境を設定します
2. pip install -r requirements.txt を使用して必要な依存関係をインストールします
3. 上記のとおりに VS Code の設定を行います
4. 以下の有効な認証情報があることを確認します。
   • Gmail アカウント（ユーザー名とパスワード）
   • Gemini API キー
   • Google Cloud サービスアカウント（GCS との統合用）

要件

• API アクセスを有効にした Gmail アカウント。
• Gmail API と Google Cloud Storage にアクセスするための Google Cloud 認証情報。
• Python 3.8 以降。

ツール

gmail-mcp-server は、Gmail アカウントの管理と分析のために以下のツールを提供します。

test_connection

• 説明：OAuth2 認証情報を使用して Gmail API の接続をテストします。
• 戻り値：接続に成功した場合、Gmail のラベル一覧を返します。

list_labels

• 説明：Gmail アカウントで利用可能なすべてのラベルを一覧表示します。
• 戻り値：ラベル名と ID の辞書。

search_emails

• 説明：IMAP 検索条件を使用して Gmail のメッセージを検索します。
• パラメーター：
  • mailbox：検索対象の Gmail ラベル（例："INBOX"）。
  • criteria：IMAP 検索条件（例："ALL"）。
  • limit：返すメッセージの最大件数。
• 戻り値：検索条件に一致する Gmail メッセージの一覧。

get_email

• 説明：メッセージ ID を指定して、メールの全内容を取得します。
• パラメーター：
  • mailbox：メッセージを含む Gmail ラベル。
  • message_id：メールの一意の識別子。
• 戻り値：メールの内容とメタデータ。

analyze_inbox

• 説明：メールのパターンを分析し、Gmail の受信トレイに関するインサイトを提供します。
• パラメーター：
  • days：分析する日数（デフォルト：7）。
• 戻り値：メールのアクティビティ、送信者のパターンなどに関するインサイト。

get_total_messages

• 説明：受信トレイ内のメッセージ総数を取得します。
• 戻り値：メッセージの合計数。

analyze_inbox_state

• 説明：受信トレイの状態を包括的に分析します。
• パラメーター：
  • max_messages：分析するメッセージの最大数（デフォルト：100）。
• 戻り値：送信者のアクティビティ、メールの種類、添付ファイルの統計情報などの分析結果。

move_message

• 説明：メッセージをあるフォルダーから別のフォルダーに移動します。
• パラメーター：
  • uid：メールメッセージの一意の識別子。
  • from_folder：メッセージが格納されている移動元のフォルダー。
  • to_folder：メッセージの移動先のフォルダー。
• 戻り値：操作の成功ステータス。

create_smart_folder

• 説明：指定したフィルタールールでスマートフォルダーを作成します。
• パラメーター：
  • name：スマートフォルダーの名前。
  • rules：フォルダーのフィルタールールのリスト。
• 戻り値：作成されたスマートフォルダーの詳細。

batch_process

• 説明：条件に基づいて複数のメールを一括処理します。
• パラメーター：
  • folder：処理するメールが格納されているフォルダー。
  • action：実行するアクション（例：「move」、「delete」、「label」）。
  • filter_criteria：メールのフィルター条件。
• 戻り値：一括処理の結果。

migrate_email_to_gcs

• 説明：メールメッセージを Google Cloud Storage に移行します。
• パラメーター：
  • uid：メールメッセージの一意の識別子。
  • folder：メッセージが格納されているフォルダー。
  • gcs_prefix：メールの保存先となる GCS フォルダー。
• 戻り値：保存されたメールデータと添付ファイルのパス。

get_folder_summary

• 説明：フォルダーの概要統計情報を取得します。
• パラメーター：
  • folder：概要統計情報を取得するフォルダー。
• 戻り値：メッセージ数やアクティビティの傾向などの概要統計情報。

search_messages

• 説明：Gmail の検索構文を使用して Gmail メッセージを検索します。
• パラメーター：
  • query：Gmail の検索クエリ（例：「from:[email protected] has:attachment」）。
  • max_results：返すメッセージの最大数。
• 戻り値：条件に一致する Gmail メッセージのリスト。

get_thread

• 説明：Gmail のスレッド内のすべてのメッセージを取得します。
• パラメーター：
  • thread_id：取得するスレッドの ID。
• 戻り値：スレッドとそのメッセージ。

get_messages

• 説明：必要に応じてラベルでフィルタリングして Gmail メッセージを取得します。
• パラメーター：
  • label_ids：フィルタリングに使用する Gmail ラベル ID の任意のリスト。
  • max_results：返すメッセージの最大数。
• 戻り値：Gmail メッセージのリスト。

はじめに

1. Gmail API の認証情報を設定します。
2. Gmail 固有の設定でサーバーを構成します。
3. サーバーを実行して、Gmail の受信トレイの管理と分析を開始します。

詳しいセットアップ手順については、セットアップガイドを参照してください。