Gmail Plugin MCP Server

Gmail Plugin MCP Server

Gmail と連携し、MCP クライアントから直接メールを管理できる強力な MCP サーバーです。このプラグインを使うと、メールの閲覧、送信、管理など、Gmail の主要機能をシームレスに利用できます。

参考：uvx を使用した MCP サーバー実装のサンプルについては、こちらの例をご覧ください。

🎥 デモ

https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f

✨ 機能

• 📧 メールの送受信
• 📥 未読メッセージの閲覧
• 🗑️ メールをゴミ箱に移動
• 📱 ブラウザーでメールを開く
• 📝 メールを既読にする
• 🔒 安全な OAuth2 認証

🚀 クイックスタート

前提条件

• Python 3.12 以上
• Gmail API の認証情報
• MCP クライアント（Claude Desktop など）

インストール

1. リポジトリをクローンします。

git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin

2. 依存関係をインストールします（以下から方法を選択してください）。

# Method 1: Install in editable mode
uv pip install -e .

# Method 2: Install using requirements.txt
uv pip install -r requirements.txt

# Method 3: Install using uv sync (recommended)
uv sync --dev --all-extras

3. Gmail API の認証情報を設定します。
   • Google Cloud Console にアクセスします
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
   • Gmail API を有効にします
   • OAuth 同意画面を設定します。
     • ユーザータイプに「External」を選択します（公開は不要です）
     • Audiences タブを開き、メールアドレスを「Test user」として追加します
     • OAuth スコープを追加します：https://www.googleapis.com/auth/gmail/modify
   • OAuth 2.0 認証情報を作成します。
     • アプリケーションの種類として「Desktop App」を選択します
     • JSON 形式の認証情報ファイルをダウンロードします
   • 認証情報ファイルを保存し、その絶対パスを控えておきます（--creds-file-path に使用します）

設定

開発中／未公開のサーバーの場合

MCP クライアントの設定に次の内容を追加します。

"mcpServers": {
  "gmail-plugin": {
    "command": "uv",
    "args": [
      "--directory",
      "[absolute path to working directory]",
      "run",
      "server.py"
      "--creds-file-path",
      "[absolute-path-to-credentials-file]",
      "--token-path",
      "[absolute-path-to-access-tokens-file]"
    ]
  }
}

公開済みサーバーの場合

"mcpServers": {
  "gmail-plugin": {
    "command": "uvx",
    "args": [
      "gmail-plugin"
    ]
  }
}

🛠️ 開発

ビルドと公開

1. 依存関係を同期します。

uv sync

2. パッケージをビルドします。

uv build

3. PyPI に公開します。

uv publish

デバッグ

デバッグには MCP Inspector を使用します。

npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin

📚 API リファレンス

利用可能なツール

ツール名	説明	必須の引数
send-email	メールを送信する	recipient_id, subject, message
get-unread-emails	未読メールを取得する	なし
read-email	メールの内容を読む	email_id
trash-email	メールをゴミ箱に移動する	email_id
mark-email-as-read	メールを既読にする	email_id
open-email	ブラウザーでメールを開く	email_id

利用可能なプロンプト

プロンプト名	説明	引数
manage-email	メール管理者として振る舞う	なし
draft-email	新しいメールの下書きを作成する	content, recipient, recipient_email
edit-draft	既存のメールの下書きを編集する	changes, current_draft

🤝 貢献

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

📄 ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。