Jmonsellier Gmail MCP Server

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

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

⚠️ 重要提示

このサーバーはMCPクライアントが電子メールを読み取り、削除、送信することを許可します。ただし、クライアントはこのような操作を実行する前にユーザーに確認を求めます。

GitHubリソースリンク

✨ 主な機能

ツール

• 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-file-path パラメータにこのファイルの絶対パスを渡します。

認証

サーバーを起動すると、認証プロセスがシステムのブラウザで開始されます。
トークンの資格情報は、指定されたファイルパスに保存され（後でそこから取得されます）、そのパスは --token-path パラメータで渡されます。

例えば、ホームディレクトリ内の隠しディレクトリを使用することができます：

💻 使用例

基本的な使用法

# サンプルコード：MCPサーバーを起動するコマンド
python3 mcp_server.py --creds-file-path=/path/to/client_creds.json --token-path=/path/to/app_tokens.json

このサーバーは、Gmailとの統合を可能にし、MCPプロトコルを通じたやり取りを実現します。