GmailプラグインMCPサーバー

Pythonバージョンライセンス

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

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

🎥 デモ

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

Related MCP server: @kazuph/mcp-gmail-gas

✨ 特徴

📧 メールの送受信
📥 未読メッセージを読む
🗑️ ゴミ箱メール
📱 ブラウザでメールを開く
📝 メールを既読にする
🔒 安全な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ファイルを参照してください。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Gmail Plugin MCP Server