@kazuph/mcp-gmail-gas

MCP Gmail

Gmail統合用のモデルコンテキストプロトコルサーバー。これにより、Claude Desktop（または任意のMCPクライアント）はGoogle Apps Scriptを介してGmailアカウントとやり取りできるようになります。

クイックスタート（ユーザー向け）

前提条件

• Node.js 18+ ( brew install nodeでインストール)
• Gmailアカウント
• Google Apps Scriptのデプロイメント
• Claude Desktop ( https://claude.ai/desktopからインストール)

構成

1. Google Apps Scriptをデプロイする

• Google Apps Scriptにアクセスして新しいプロジェクトを作成します
• code.gsの内容全体をコピーし、スクリプトエディタに貼り付けます。
• 「デプロイ」>「新しいデプロイ」をクリックします
• 展開タイプとして「Webアプリ」を選択します
• 次の設定を構成します。
  • 実行者: 私
  • アクセスできるユーザー: 誰でも
  • 「デプロイ」をクリック
• プロンプトが表示されたら、アプリを確認して Gmail アカウントへのアクセスを許可します。
• デプロイURLをコピーし、セキュリティのためにランダムなAPIキーを生成します

注: このスクリプトにはGmailへのアクセス権限が必要です。スクリプトを初めてデプロイして実行する際、Googleからこれらの権限の確認と付与を求められます。以下の点にご注意ください。

1. 「権限を確認」をクリックします
2. Googleアカウントを選択してください
3. 警告が表示された場合は「詳細設定」をクリックしてください
4. 「[プロジェクト名] に移動 (安全ではありません)」をクリックします。
5. 「許可」をクリックして、必要なGmail権限を付与します
6. Claude Desktop 構成ファイルを開きます: ~/Library/Application Support/Claude/claude_desktop_config.json

これは、Claude デスクトップ メニューから見つけることができます。

1. クロードデスクトップを開く
2. MacのメニューバーでClaudeをクリック
3. 「設定」をクリック
4. 「開発者」をクリック
5. 設定に以下を追加します。

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

開発者向け

前提条件

• Node.js 18+ ( brew install nodeでインストール)
• Gmailアカウント
• Google Apps スクリプト
• Claude Desktop ( https://claude.ai/desktopからインストール)
• tsx ( npm install -g tsxでインストール)

インストール

開発構成

1. Claude Desktop がインストールされ、実行されていることを確認してください。
2. まだインストールしていない場合は、tsx をグローバルにインストールします。

3. Claude Desktop の設定を変更してください: ~/Library/Application Support/Claude/claude_desktop_config.json

MCP クライアントの構成に以下を追加します。

利用可能なツール

• gmail_search_messages : Gmailの検索クエリ構文を使用してメールを検索します（例： "subject:Meeting newer_than:1d"）
• gmail_get_message : 特定のメールの全内容と詳細を取得します
• gmail_download_attachment : 特定のメールから添付ファイルをダウンロードする

セキュリティに関する注意事項

VALID_API_KEYは常に秘密にし、バージョン管理にコミットしないでください。このキーは、Google Apps Script の導入を通じて、承認されたクライアントのみが Gmail にアクセスできるようにするために役立ちます。