@kazuph/mcp Gmail Gas

🚀 MCP Gmail サーバーサイド

このモデルコンテキストプロトコル (MCP) サーバーは、Gmail との統合に使用されます。Claude デスクトップ版（または他の MCP クライアント）が Google Apps スクリプトを介してあなたの Gmail アカウントとやり取りできるようにします。

🚀 クイックスタート（ユーザー）

前提条件

• Node.js 18+（brew install node でインストール）
• Gmail アカウント
• Google Apps スクリプトのデプロイ
• Claude デスクトップ版（https://claude.ai/desktop からダウンロードしてインストール）

設定

1. Google Apps スクリプトをデプロイする

• Google Apps Script にアクセスして新しいプロジェクトを作成します。
• code.gs ファイルのすべての内容をコピーして、スクリプトエディタに貼り付けます。
• 「デプロイ」>「新しいデプロイ」をクリックします。
• デプロイタイプとして「ウェブアプリ」を選択します。
• 以下の設定を構成します：
  • 実行するユーザー：自分自身
  • アクセス権限：誰でも
  • 「デプロイ」をクリックします。
• ポップアップが表示されたら、スクリプトが Gmail アカウントにアクセスするための権限を確認し、承認します。
• デプロイ URL をコピーし、セキュリティを確保するためにランダムな API キーを生成します。

⚠️ 重要提示

スクリプトには Gmail へのアクセス権限が必要です。初めてスクリプトをデプロイして実行するとき、Google はこれらの権限を確認して許可するように求めます。以下の手順を確実に行ってください：

1. 「権限を確認する」をクリックします。
2. Google アカウントを選択します。
3. 警告が表示された場合は、「詳細」をクリックします。
4. 「[あなたのプロジェクト名] (安全ではない) へ移動」をクリックします。
5. 「許可」をクリックして、必要な Gmail 権限を付与します。

2. Claude デスクトップ版の設定ファイルを開きます： ~/Library/Application Support/Claude/claude_desktop_config.json

このファイルは以下の手順で見つけることができます：

1. Claude デスクトップ版を開きます。

2. メニューバーの「Claude」をクリックします。

3. 「設定」を選択します。

4. 「開発者」をクリックします。

5. 設定ファイルに以下の内容を追加します：

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

⚠️ 重要提示

YOUR_DEPLOYMENT_URL と YOUR_API_KEY を実際の値に置き換えてください。

📚 ドキュメント（開発者向け）

前提条件

• Node.js 18+（brew install node でインストール）
• Gmail アカウント
• Google Apps スクリプト
• Claude デスクトップ版（https://claude.ai/desktop からダウンロードしてインストール）
• tsx（npm install -g tsx でインストール）

インストール

git clone https://github.com/kazuph/mcp-gmail-gas.git
cd mcp-gmail-gas
npm install
npm run build

開発設定

1. Claude デスクトップ版がインストールされ、実行されていることを確認します。

2. まだインストールされていない場合は、tsx をグローバルにインストールします：

npm install -g tsx
# または
pnpm add -g tsx

3. Claude デスクトップ版の設定ファイルを編集します。このファイルは以下の場所にあります： ~/Library/Application Support/Claude/claude_desktop_config.json

MCP クライアントの設定に以下の内容を追加します：

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

利用可能なツール

このプロジェクトでは、以下の機能が提供されています：

1. メールを検索する
2. 特定のメールの内容を取得する
3. 添付ファイルをダウンロードする

注意事項

• ⚠️ 重要提示：セキュリティを最優先にしてください。API キーの機密性を確保し、漏洩によるセキュリティリスクを避けてください。
• ⚠️ 重要提示：権限管理を適切に行ってください。Google Apps スクリプトの権限を適切に設定し、不正なアクセスを防いでください。

このプロジェクトを使用することで、Claude デスクトップ版と Gmail を簡単に統合し、自動化されたメール処理タスクを実行できます。