Gmail MCP Server

🚀 Gmail サーバー モデルコンテキストプロトコル（MCP）

この MCP サーバーは Gmail と統合されており、メールの送信、削除、読み取り、下書き作成、返信などの機能を有効にします。

⚠️ 重要提示

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

🚀 クイックスタート

この MCP サーバーは Gmail と連携し、メールの送受信や管理を行うことができます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• メールの送信、削除、読み取り、下書き作成、返信機能を提供します。
• ユーザーに確認を求めることで、安全な操作を保証します。

📦 インストール

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 で指定された絶対ファイルパスに保存（および後で取得）されます。

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

使用方法

サーバーを起動するには、以下のコマンドを実行します。

python3 src/main.py --config config.yaml

検証

サーバーが正常に動作していることを確認するには、以下の手順を実行します。

1. テストメールを送信します。
2. 受信トレイを確認して、メールが届いていることを確認します。

トラブルシューティング

何か問題が発生した場合は、以下の点を確認してください。

• Gmail API が正しく有効になっていることを確認します。
• OAuth 資格情報が有効であることを検証します。
• ログファイルを確認して、詳細な情報を取得します。

📚 ドキュメント

コンポーネント

ツール

• 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
  • 成功メッセージを返し、デフォルトのブラウザで指定されたメールを開きます。

📄 ライセンス

更新履歴

バージョン 1.0.0 - 初回リリース