強化された Gmail MCP サーバー

Pythonで書かれた、Gmail連携のための強力で機能豊富なモデルコンテキストプロトコル（MCP）サーバーです。このサーバーにより、ClaudeのようなAIアシスタントが自然言語でGmailとやり取りできるようになり、包括的なメール管理機能を提供します。

🌟 主な特徴

📧 完全なメール管理

件名、内容、受信者をカスタマイズしてメールを送信します
完全なメタデータを含むメールの内容を読み取り、取得します
確認してメールをゴミ箱に移動する
メールを既読/未読としてマークする
ブラウザで直接メールを開く

📝 ドラフト管理

後で確認できるようにメールの下書きを作成する
すべての下書きメールを一覧表示する
既存の下書きを編集する

🏷️ 高度なラベル管理

利用可能なすべてのラベルを一覧表示する
カスタムラベルを作成する
メールにラベルを適用/削除する
既存のラベルの名前を変更する
未使用のラベルを削除する
ラベルでメールを検索する

📁 フォルダの整理

新しいフォルダを作成する（Gmail ラベルとして実装）
フォルダ間でメールを移動する
利用可能なすべてのフォルダを一覧表示する

🔍 強力な検索とフィルタリング

Gmail の高度なクエリ構文を使用してメールを検索する
メールフィルターの作成、管理、削除
送信者、受信者、件名、コンテンツなどでフィルタリング
柔軟なパラメータで検索結果をカスタマイズ

🗄️ アーカイブ管理

メールをアーカイブする（削除せずに受信トレイから削除）
検索条件に一致する複数のメールを一括アーカイブ
アーカイブされたメールをすべて一覧表示する
アーカイブされたメールを受信トレイに復元する

🚀 はじめに

前提条件

Python 3.8以上
Gmail API が有効になっている Google Cloud プロジェクト
OAuth 2.0 認証情報

インストール

# Clone the repository
git clone https://github.com/theposch/gmail-mcp.git
cd gmail-mcp

# Set up a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install the package
pip install -e .

Google Cloud のセットアップ

新しい Google Cloud プロジェクトを作成する
Gmail APIを有効にする
OAuth 同意画面を設定します。
- 「外部」ユーザータイプを選択
- テストユーザーとしてメールアドレスを追加する
- スコープを追加します: https://www.googleapis.com/auth/gmail/modify
OAuth 2.0 認証情報を作成する:
- アプリケーションの種類として「デスクトップアプリ」を選択します
- JSON認証情報ファイルをダウンロードする

構成

資格情報を安全に保存し、サーバーを実行するときにその場所を指定します。

# Example directory structure for credentials
mkdir -p ~/.gmail-mcp
# Move your downloaded credentials file
mv ~/Downloads/client_secret_*.json ~/.gmail-mcp/credentials.json

🔧 使用方法

Claude Desktopで実行

Claude Desktop 構成ファイル (通常は~/Library/Application Support/Claude/claude_desktop_config.json ) に次のコードを追加します。

{
  "mcpServers": {
    "gmail": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/gmail-mcp",
        "run",
        "gmail",
        "--creds-file-path",
        "/absolute/path/to/credentials.json",
        "--token-path",
        "/absolute/path/to/tokens.json"
      ]
    }
  }
}

MCP Inspectorによるテスト

テストとデバッグには、MCP インスペクターを使用します。

npx @modelcontextprotocol/inspector uv run /path/to/gmail-mcp/src/gmail/server.py --creds-file-path /path/to/credentials.json --token-path /path/to/tokens.json

🔐 セキュリティに関する考慮事項

資格情報やトークンファイルをバージョン管理にコミットしないでください
適切な権限を持つ安全な場所に資格情報を保存する
サーバーは機密性の高いアクションを実行する前にユーザーの確認を求めます
Google Cloud Console で異常なアクティビティがないか定期的に確認する
機密パスには環境変数の使用を検討する

🛠️ 建築

この実装は、Google API クライアントライブラリを通じてすべての Gmail 操作を処理する包括的な単一ファイルアーキテクチャを備えています。主なコンポーネントは次のとおりです。

自動トークン更新機能を備えたOAuth2認証
包括的なエラー処理とログ記録
明確な入力スキーマを備えた構造化されたツール定義
効率的なメール解析とフォーマット

📚 プロンプトの例

Gmail MCP サーバーに接続した後、Claude で次のプロンプトを試してください。

「未読メールを見せて」
「 example@domain.comからの添付ファイル付きメールを検索する」
「「重要なプロジェクト」という新しいラベルを作成します」
「今後の会議に関するメールをjohn@example.com宛てに作成する」
「 newsletter@example.comからのすべてのメールをアーカイブする」
「チームからのメールに自動的にラベルを付けるフィルターを作成する」

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

📄 ライセンス

このプロジェクトは GPL-3.0 ライセンスの下でライセンスされています - 詳細については LICENSE ファイルを参照してください。

🙏 謝辞

コミュニティ内のさまざまなMCPサーバー実装に触発されて
モデルコンテキストプロトコルフレームワークで構築
Googleの公式APIクライアントライブラリを使用

Enhanced Gmail MCP Server

Integrations