Jasonsum Gmail MCP Server

🚀 Gmail サーバー用モデルコンテキストプロトコル (MCP)

この MCP サーバーは Gmail と統合されており、メールの送信、削除、閲覧、作成、返信を可能にします。

⚠️ 重要提示

このサーバーにより、MCP クライアントはメールを読み取り、削除、送信できます。ただし、クライアントはこのようなアクティビティを実行する前にユーザーに確認を求めます。

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

✨ 主な機能

ツール

• send-email

  • 受信者のアドレスにメールを送信します。
  • 入力：
    • recipient_id (文字列)：受信者のメールアドレス
    • subject (文字列)：メールの件名
    • message (文字列)：メールの内容
  • ステータスとメッセージ ID を返します。

• trash-email

  • メールをゴミ箱に移動します。
  • 入力：
    • email_id (文字列)：自動生成されたメール ID
  • 成功メッセージを返します。

• mark-email-as-read

  • メールを既読にマークします。
  • 入力：
    • email_id (文字列)：自動生成されたメール ID
  • 成功メッセージを返します。

• get-unread-emails

  • 未読メールを検索します。
  • 未読メールのリスト（メール ID を含む）を返します。

• read-email

  • 指定されたメールの内容を検索します。
  • 入力：
    • email_id (文字列)：自動生成されたメール ID
  • メールのメタデータを含む辞書を返し、メールを既読にマークします。

• open-email

  • ブラウザでメールを開きます。
  • 入力：
    • email_id (文字列)：自動生成されたメール ID
  • 成功メッセージを返し、デフォルトのブラウザで指定されたメールを開きます。

📦 インストール

Gmail API の設定

1. 新しい Google Cloud プロジェクトを作成
2. Gmail API を有効にする
3. OAuth 同意画面を設定
   • 「外部」を選択します。ただし、このアプリケーションは公開しません。
   • あなたの個人メールアドレスを「テストユーザー」として追加します。
4. OAuth スコープ https://www.googleapis.com/auth/gmail/modify を追加します。
5. アプリケーションタイプの OAuth クライアント ID を作成し、「デスクトップアプリケーション」を選択します。
6. クライアントの OAuth キーファイル JSON ファイルをダウンロードします。
7. キーファイルをリネームし、ローカルコンピュータの安全な場所に保存します。このパスを覚えておいてください。
   • サーバーを起動する際に、このパスをパラメータ --creds で指定します。

認証

以下のコマンドを実行して認証を行います：

python -m gmail_mcp --creds path/to/your/credentials.json

これにより、デフォルトのブラウザウィンドウが開き、Google の OAuth フローが完了します。完了すると、成功メッセージが表示され、path/to/your/credentials.json の場所に crets.json ファイルが作成されます。

これで Gmail MCP サーバーを使用できます！