Gmail MCP - Instalación Automática y Segura

Gmail MCP - 自動かつ安全なインストール

Model Context Protocol（MCP）を介して、AI アシスタントが Gmail にアクセスできます。

必須要件： この MCP サーバーを使用するには、Claude Desktop がインストールされている必要があります。

🧪 MCP とは？

MCP（Model Context Protocol）は、言語モデル（ChatGPT や Claude など）と外部ツール（API、データベース、ウェブサービスなど）との通信を容易にするために Antrophic が開発した統合プロトコルです。モデルに拡張された構造化済みのリアルタイムコンテキストを提供し、テキスト以外の操作も実行できるようにすることを目的としています。

---

🎥 使用例の動画

https://github.com/user-attachments/assets/e49b2d76-bcef-4d44-9222-6818f0f57998

🚀 クイックインストール（Windows）

1. まず、次の操作を行います。
   • Google Cloud Console にアクセスします。
   • プロジェクトを作成し、Gmail API を有効にします。
   • http://localhost:8080/ を承認済みのリダイレクト URIに追加します。
   • client_secret_...json ファイルをダウンロードして、ダウンロードフォルダーに保存します（ファイル名や最終的な保存場所は気にしなくてかまいません）。
   • インストーラーがファイルを検出し、適切な名前を付けて正しいフォルダーに自動的に移動します。

重要

Google Cloud から認証情報ファイルをダウンロードするには、承認済みのリダイレクト URIを設定してから、ダウンロードフォルダーに保存するだけです。ファイル名や最終的な保存場所は気にしなくてかまいません。インストーラーがすべて処理します。

2. ターミナルからこのリポジトリをクローンします。

   git clone https://github.com/FranciscoYuster/claude-client-gmail-mcp
   cd claude-client-gmail-mcp
   

3. スクリプトを実行します。

   python setup.py
   

4. インストーラーが残りの処理を行います。
5. 最後のメッセージが表示されたら、Claude Desktop を開いてお使いください。

---

💻 macOS / Linux へのインストール

1. 上記の Google Cloud の手順に従って認証情報ファイルを取得し、ダウンロードフォルダーに保存します。
2. ターミナルからこのリポジトリをクローンします。

   git clone https://github.com/FranciscoYuster/gmail-client-mcp-server
   cd gmail-client-mcp-server
   

3. Unix システム用のスクリプトを実行します。

   python3 setupUnix.py
   

4. インストーラーが残りの処理を行います。
5. 最後のメッセージが表示されたら、Claude Desktop を開いてお使いください。

---

重要

Windowsの場合は、python setup.pyを実行してください。 macOS または Linuxの場合は、python3 setupUnix.pyを実行してください。 どちらのスクリプトもインストールを実行しますが、それぞれのオペレーティングシステムに合わせて調整されています。

---

🔒 セキュリティ

警告

**認証情報ファイルをアップロードしたり、共有したりしないでください。**誤って公開してしまった場合は、そのファイルを削除し、Google Cloud Console で新しいファイルを生成してください。このスクリプトが機密データをアップロードしたり、配布したりすることはありません。

---

📝 前提条件

• Python 3.11 以降
• git
• Gmail アカウント
• Claude Dekstop

ヒント

インストーラーが、不足している要件のインストールを案内します。

---

⚙️ 手動設定

🚀 設定

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

   git clone https://github.com/FranciscoYuster/claude-client-gmail-mcp
   cd claude-client-gmail-mcp
   

2. 仮想環境を作成して有効化します。

   uv init
   # o alternativamente
   uv venv
   

   次に、有効化します。

   .venv\scripts\activate
   

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

   uv pip install -r requirements.txt
   

4. OAuth 認証情報を設定します。
   • プロジェクトのルートにcredentialsというディレクトリを作成します。
   • Google Cloud Console でプロジェクトを作成します。
   • Gmail API を有効にします。
   • OAuth 認証情報を作成します。
   • 次の URI を承認済みのリダイレクト URIに追加します。

     http://localhost:8080/
     

   • 認証情報の JSON ファイルをダウンロードし、credentials/client_secret_gmail_oauth.jsonとして保存します。

注意

認証エラーを防ぐため、認証情報ファイルのパスとファイル名が正しいことを確認してください。

5. MCP サーバーを JSON 設定に追加します。具体的な手順については、使用する MCP クライアントの公式ドキュメントを参照してください。環境に合わせてパスを調整してください。

   {
       "mcpServers": {
           "gmail-mcp": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/path/to/your/gmail-mcp/src",
                   "run",
                   "main.py"
               ]
           }
       }
   }
   

6. Claude Desktop を起動します。

---

利用可能なツール

このサーバーには、AI アシスタントから Gmail を操作・自動化するためのさまざまなツールが含まれています。これらのツールを使って、メールやラベルの送信、読み取り、検索、管理ができます。主な機能は以下のとおりです。

メール操作

• メールを送信する（添付ファイル、CC、BCC、スレッドへの返信に対応）
• メールの下書きを作成する（添付ファイルに対応）
• メッセージから添付ファイルをダウンロードする
• ID でメールを読み取る（テキストと HTML、大きなメッセージの分割に対応）
• 高度なフィルターでメールを検索する（クエリ、ラベル、送信者、添付ファイル、ページネーション）
• 会話のスレッド全体を取得する
• 既読／未読／重要／重要でないに設定する

ラベル管理

• メールにラベルを追加または削除する
• 新しいラベルを作成する
• 名前でラベルを削除する
• すべてのラベルを一覧表示する
• 名前でラベルを取得または作成する
• ラベルの設定を更新する（名前、表示設定、色）
• 名前でラベルを検索する

これらのツールにより、Gmail のメールやラベルを高度かつ自動的に管理でき、AI アシスタントやワークフローとの連携が容易になります。

📝 ライセンス

MIT です。LICENSE ファイルを参照してください。