📬 Claude デスクトップ用 EmailAssistant

EmailAssistantは、Gmail APIと連携し、カスタムクエリや最近のアクティビティに基づいてメールを取得・要約するMCP対応サーバーです。Claude Desktopと併用することで、受信トレイをハンズフリーで操作できます。

⚙️ セットアップ手順

1. Gmail APIを有効にする

1. Google Cloud Consoleに移動します。

2. 新しいプロジェクトを作成するか、既存のプロジェクトを使用します。

3. 「API とサービス」でGmail APIを有効にします。

4. OAuth 2.0 クライアント ID資格情報を作成します。

5. client_secret_XXXXX.jsonファイルをダウンロードします。

Related MCP server: Gmail MCP Server

🔧 構成の概要

🔁 config.pyでこれらを置き換えます

• /absolute/path/to/your/projectローカルの EmailAssistant プロジェクト ディレクトリへの完全なパスに置き換えます。

• "your_client_secret_file.json" Google Cloud からダウンロードした OAuth 認証情報の正確なファイル名に置き換えます。

🖥️ 3. クロードデスクトップ構成

Claude Desktop 構成ファイル内:

{
  "mcpServers": {
    "EmailAssistant": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth-httplib2",
        "--with",
        "google-auth-oauthlib",
        "mcp",
        "run",
        "/absolute/path/to/your/project/MCPEmailAssistant/main.py"
      ]
    }
  }
}

✅ 実行する

設定が完了したら:

1. Claudeデスクトップを起動

2. Claude はEmailAssistant MCP サーバーを自動的に認識します。

3. Claude を使用して次のような関数を呼び出すことができるようになりました。

get_email_summary(time="newer_than:1d")
get_top_matching_email(query_keywords="project deadline")

📌 要件

• Python 3.9以上

• uv ( uvを使用していない場合はpipを使用)

• 次の Python パッケージ:

  • google-api-python-client

  • google-auth-httplib2

  • google-auth-oauthlib

  • mcp[cli]