GmailプラグインMCPサーバー

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

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

🎥 デモ

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

Related MCP server: mcp-gmail

✨ 特徴

• 📧 メールの送受信

• 📥 未読メッセージを読む

• 🗑️ ゴミ箱メール

• 📱 ブラウザでメールを開く

• 📝 メールを既読にする

• 🔒 安全なOAuth2認証

🚀 クイックスタート

前提条件

• Python 3.12以上

• Gmail API 認証情報

• MCP クライアント (Claude Desktop など)

インストール

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

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

2. 依存関係をインストールします (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

3. 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"
    ]
  }
}

🛠️ 開発

建築と出版

1. 同期の依存関係:

uv sync

2. ビルドパッケージ:

uv build

3. PyPI に公開:

uv publish

デバッグ

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

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

📚 APIリファレンス

利用可能なツール

利用可能なプロンプト

🤝 貢献する

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

📄 ライセンス

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