Gmail Sender MCP

🚀 Gmail 発信者 MCP サーバー

このプロジェクトは、Claudeやその他のAIアシスタントがGmail APIを通じて電子メールを送信できるようにする、モデルコンテキストプロトコル（MCP）サーバーです。現バージョンは、電子メール送信機能のみを提供することに焦点を当てています。

🚀 クイックスタート

このMCPサーバーは、AIアシスタントが以下の操作を行えるように設計されています。

• 新しい電子メールを送信する
• 既存の電子メールに返信する

軽量で設定が簡単で、Gmail APIを使用して電子メール操作を行います。

✨ 主な機能

• 新規メール送信：AIアシスタントが新しい電子メールを送信できます。
• 既存メール返信：AIアシスタントが既存の電子メールに返信できます。

📦 インストール

前提条件

• Python 3.8以上
• Gmail APIが有効になっているGoogle Cloudアカウント
• Docker（コンテナ化デプロイ用、オプション）

設定手順

1. Google Cloudプロジェクトを作成し、Gmail APIを有効にする

1. Google Cloudコンソールにアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. サイドバーで「APIとサービス」>「ライブラリ」に移動します。
4. 「Gmail API」を検索し、有効にします。
5. 「APIとサービス」>「認証情報」に移動します。
6. 「認証情報を作成」をクリックし、「OAuthクライアントID」を選択します。
7. アプリケーションの種類として、「デスクトップアプリ」を選択します。
8. OAuthクライアントに名前を付けます。
9. 「作成」をクリックします。
10. 生成された認証情報のJSONファイルをダウンロードします。

2. 環境を準備する

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

git clone https://github.com/abhishekloiwal/gmail-sender-mcp.git
cd gmail-sender-mcp

依存関係をインストールします。

pip install -r requirements.txt

3. 認証情報を設定する

1. ダウンロードした認証情報ファイルをcredentials.jsonにリネームし、プロジェクトのルートディレクトリに配置します。
2. リフレッシュトークンを取得するための補助スクリプトを実行します。

python get_refresh_token.py

3. ブラウザで認証フローを完了します。
4. ターミナルに表示されたリフレッシュトークンをコピーします。
5. サンプルに基づいて.envファイルを作成します。

cp .env.example .env

6. .envファイルを編集し、認証情報を入力します。

GMAIL_CLIENT_ID=your-client-id.apps.googleusercontent.com
GMAIL_CLIENT_SECRET=your-client-secret
GMAIL_REFRESH_TOKEN=your-refresh-token
GMAIL_USER_EMAIL=your-email@gmail.com

4. MCPサーバーを起動する

python gmail_sender.py

サーバーが起動し、接続を待機します。

Dockerを使用したデプロイ

Dockerコンテナでサーバーを実行することもできます。

Dockerを使用してビルドし、実行する

docker build -t gmail-sender-mcp .
docker run -d --name gmail-sender-mcp --env-file .env gmail-sender-mcp

またはDocker Composeを使用する

docker-compose up -d

💻 使用例

基本的な使用法

以下はsend_emailツールを使用した例です。

from gmail_sender import GmailSender

# Gmail送信機を初期化する
gmail = GmailSender(
    client_id='your-client-id.apps.googleusercontent.com',
    client_secret='your-client-secret',
    refresh_token='your-refresh-token',
    user_email='your-email@gmail.com'
)

# 電子メールを送信する
gmail.send_email(
    to='recipient@example.com',
    subject='テストメール',
    body='これはテストメールです。'
)

📚 ドキュメント

MCPサーバーのツール

send_emailツール

新しい電子メールを送信します。

reply_to_emailツール

既存の電子メールに返信します。

🔧 技術詳細

エラーハンドリング

Gmail APIを使用する際には、以下のエラーが発生する可能性があります。

• InvalidGrantError：リフレッシュトークンが無効または期限切れです。
• RateLimitExceeded：APIのクォータ制限を超えています。
• PermissionDenied：必要な権限がありません。

認証情報が有効で、Google Cloudプロジェクトで正しいAPIが有効になっていることを確認してください。

環境変数の説明

.envファイルで使用される環境変数とその意味は以下の通りです。

📄 ライセンス

READMEにライセンス情報が記載されていないため、このセクションは省略されています。

🔐 セキュリティに関する注意事項

• .envファイルを安全に保管し、バージョン管理システムに決してコミットしないでください。
• リフレッシュトークンはメール送信権限を付与するため、パスワードと同じように扱ってください。
• セキュリティに懸念がある場合は、この統合に専用のGoogleアカウントを使用することを検討してください。

❓ よくある質問

• 認証エラー：.envファイルの認証情報が正しいことを確認してください。
• モジュールが見つからないエラー：Python環境にすべての依存関係が正しくインストールされていることを確認してください。
• APIクォータ制限：Gmail APIのクォータ制限に達した場合は、Google Cloudサポートにクォータを増やすように依頼してください。