Gmail

🚀 Gmail MCP サーバー

Claude Desktop のような MCP クライアントに Gmail 統合機能を提供する、モデルコンテキストプロトコル (Model Context Protocol) サーバーです。

✨ 主な機能

• 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_CREDENTIALS_FILE="/path/to/credentials.json" \
GMAIL_TOKEN_FILE="/path/to/token.json" \
python -m gmail_mcp_server.server

高度な使用法

Claude Desktop を通じて Gmail の機能を利用するために、claude_desktop_config.json を適切に設定することで、安全に Gmail の情報にアクセスできます。

📚 ドキュメント

利用可能なリソース

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

利用可能なツール

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

検索例：

過去 2 日間に sanrio からのメールを表示してくれますか？

セキュリティ

このサーバーは、OAuth2 を通じて Gmail との認証を必要とします：

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

環境変数

• GMAIL_CREDENTIALS_FILE（必須）：Google OAuth クレデンシャルファイルのパス
• GMAIL_TOKEN_FILE（必須）：トークン保存先のパス

開発

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

• 最新のメールを取得するためのリソースアクセス
• メール検索ツールのサポート
• 権限管理とログ記録
• 拡張可能なイベント処理メカニズム

コントリビューションガイド

もしこのプロジェクトに貢献したい場合は、以下のガイドに従ってください：

1. 新機能または修正のためのブランチを作成する。
2. 変更をコミットし、行った変更を説明する適切なコミットメッセージを追加する。
3. メインリポジトリにプルリクエストを送信し、問題追跡システムで関連する issue を参照する。

コードがプロジェクトのコーディング規約に準拠し、既存のテストスイートを通過することを確認してください。