Gmail MCP Server Yv2

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

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

⚠️ 重要提示

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

GitHub リソースリンク

✨ 主な機能

この MCP サーバーを使用することで、Gmail との連携を通じて電子メールの様々な操作を行うことができます。

📦 インストール

必要な依存関係のインストール

• pip を使用して必要なライブラリ（google-api-python-client など）をインストールします。

環境変数の設定

• Google API のアクセス情報（クライアント ID とクライアントシークレット）を設定します。

サーバーの起動

• 提供されたコマンドを使用してサーバーを起動し、crets-file-path と access-tokens-file のパスを指定します。

📚 ドキュメント

コンポーネント

ツール

• 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 で渡します。

認証

サーバーを起動すると、認証プロセスがシステムのブラウザで自動的に開始されます。

• 画面上の指示に従って権限を付与することで、設定を完了します。

🔧 トラブルシューティング

• 問題が発生した場合は、以下の点を確認してください。
  • Google API プロジェクトが正しく設定されていることを確認します。
  • OAuth プロセスが正常に完了し、エラーがないことを確認します。
  • ログを確認して詳細な情報を取得します。

以上の手順に従うことで、Gmail MCP サーバーを正常に設定し、アプリケーションに統合することができます！