GmailプラグインMCPサーバー

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 など)

インストール

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

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

依存関係をインストールします (1 つの方法を選択):

# 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

Gmail API の資格情報を設定します。
- Google Cloud Consoleに移動
- 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください
- Gmail APIを有効にする
- OAuth 同意画面を設定します。
  - 「外部」ユーザータイプを選択（公開は不要）
  - オーディエンスタブに移動して、「テストユーザー」としてメールアドレスを追加します
  - OAuth スコープの追加: https://www.googleapis.com/auth/gmail/modify
- OAuth 2.0 認証情報を作成します。
  - アプリケーションの種類として「デスクトップアプリ」を選択します
  - 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"
    ]
  }
}

🛠️ 開発

建築と出版

同期の依存関係:

uv sync

ビルドパッケージ:

uv build

PyPI に公開:

uv publish

デバッグ

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

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

📚 APIリファレンス

利用可能なツール

ツール名	説明	必須引数
`send-email`	メールを送信	受信者ID、件名、メッセージ
`get-unread-emails`	未読メールを取得する	なし
`read-email`	メールの内容を読む	メールID
`trash-email`	メールをゴミ箱に移動する	メールID
`mark-email-as-read`	メールを既読にする	メールID
`open-email`	ブラウザでメールを開く	メールID

利用可能なプロンプト

プロンプト名	説明	議論
`manage-email`	メール管理者として行動する	なし
`draft-email`	新しいメールを作成する	コンテンツ、受信者、受信者のメール
`edit-draft`	既存のメールの下書きを編集する	変更、現在のドラフト

🤝 貢献する

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

📄 ライセンス

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

Gmail Plugin MCP Server

Integrations