MCP Server Gmail Plugin For Claude Desktop

🚀 Gmail プラグイン MCP サーバー

この強力なMCPサーバーはGmailとの統合をサポートしており、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. 依存関係をインストールします（方法を選択）：

# 方法 1: 編集モードでインストール
uv pip install -e .

# 方法 2: requirements.txtを使用してインストール
uv pip install -r requirements.txt

# 方法 3: uv syncを推奨
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クライアントの設定に以下を追加します：

# 方法 1: 編集モードでインストール
uv pip install -e .

# 方法 2: requirements.txtを使用してインストール
uv pip install -r requirements.txt

# 方法 3: uv syncを推奨
uv sync --dev --all-extras

公開サーバー

app.pyに以下を追加します：

if __name__ == "__main__":
    app.run(debug=True)

🔧 開発

ビルドと公開

1. プロジェクトのルートディレクトリで以下を実行します：

uv run build

2. ビルドディレクトリ内に生成されたファイルを見つけます。

デバッグ

app.pyに以下のデバッグログを追加します：

from logging.config import dictConfig

# ログの設定
dictConfig({
    'version': 1,
    'disable_existing_loggers': False,
    'formatters': {
        'default': {
            'format': '[%(asctime)s] %(levelname)s in %(module)s: %(message)s',
        },
    },
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
            'formatter': 'default',
            'level': 'DEBUG',
        },
    },
    'root': {
        'level': 'INFO',
        'handlers': ['console'],
    },
})

📚 ドキュメント

ツール

サンプル

app.py内で：

@app.route('/')
def home():
    return "Gmail プラグイン MCP サーバーへようこそ！"

🤝 コントリビューション

1. プロジェクトのリポジトリをフォークします。
2. 機能ブランチを作成します：git checkout -b feature/your-feature
3. 変更をコミットします：git commit -m '新機能を追加'
4. フォーク先にプッシュします：git push origin feature/your-feature
5. プルリクエストを作成します。

📄 ライセンス

このプロジェクトは MIT License の下で保護されています。