Ajbr0wn Gmail MCP Server

🚀 Gmail MCP サーバー

Gmail の統合機能を提供する MCP（モデルコンテキストプロトコル）サーバーです。Claude Desktop のような MCP クライアントで使用できます。

✨ 主な機能

• Gmail 受信トレイの最新メールを確認する
• Gmail の検索構文を使ってメールを検索する
• OAuth2 ベースの安全な認証と Gmail API を利用する

📦 インストール

1. Google Cloud プロジェクトの設定

1. https://console.cloud.google.com/ で Google Cloud プロジェクトを作成する
2. Gmail API を有効にする
3. OAuth 2.0 の認証情報を作成する：
   • アプリケーションの種類：デスクトップアプリ
   • 認証情報を credentials.json としてダウンロードする

2. インストール手順

# conda 環境を作成する
conda create -n mcp-gmail python=3.12
conda activate mcp-gmail

# パッケージをインストールする
cd gmail-mcp-server
pip install -e .

3. Claude Desktop の設定

claude_desktop_config.json に以下を追加する：

{
  "mcpServers": {
    "gmail": {
      "command": "/path/to/conda/envs/mcp-gmail/bin/python",
      "args": ["-m", "gmail_mcp_server.server"],
      "env": {
        "PYTHONPATH": "/path/to/gmail-mcp-server/src",
        "GMAIL_CREDENTIALS_FILE": "/path/to/credentials.json",
        "GMAIL_TOKEN_FILE": "/path/to/token.json"
      }
    }
  }
}

/path/to/ を実際のパスに置き換えてください。初回認証時にトークンファイルが自動的に作成されます。

4. 初回実行

Claude を通じて初めて Gmail にアクセスしようとすると、ブラウザでアプリケーションの承認を求められます。承認すると、認証情報がトークンファイルに保存され、以降の使用に備えられます。

📚 ドキュメント

利用可能なリソース

• gmail://inbox/recent - 最新の 10 通のメールを返します

利用可能なツール

• search_emails
  • 説明：Gmail のメールを検索します
  • パラメータ：
    • query（必須）：Gmail の検索クエリ（Gmail の標準検索構文を使用）
    • max_results（オプション）：返す結果の最大数（デフォルト値：10）

検索例：

過去 2 日間に sanrio からのメールを表示してください。

セキュリティ

このサーバーは Gmail との OAuth2 認証が必要です：

• 初回使用時にブラウザでアプリケーションのアクセス承認を求められます
• 認証情報は指定されたトークンファイルにローカルに保存されます
• Google アカウント設定からいつでも承認を取り消すことができます
• Gmail への読み取りアクセスのみを要求します（書き込み権限はありません）

環境変数

• GMAIL_CREDENTIALS_FILE（必須）：Google OAuth の認証情報ファイルのパス
• GMAIL_TOKEN_FILE（必須）：トークンの保存場所

テストするために、サーバーを直接実行できます：

GMAIL_CREDENTIALS_FILE="/path/to/credentials.json" \
GMAIL_TOKEN_FILE="/path/to/token.json" \
python -m gmail_mcp_server.server

開発について

このサーバーは Model Context Protocol を使用して以下を提供します：

• 最近のメールへのリソースアクセス
• メール検索ツールのサポート
• 安全な認証フロー
• 自動トークン更新

ログ記録

サーバーは詳細な操作情報を stderr に記録します。内容は以下の通りです：

• サーバーの起動情報
• 認証状態
• リソースとツールの使用状況
• エラーや問題の情報

コントリビューション

プルリクエストは大歓迎です！以下の点を確認してください：

• 新機能のドキュメントを更新する
• 適切なエラーハンドリングを追加する
• 新しい OAuth フローをテストする
• 既存のコードスタイルに従う