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からインストール)
構成
Google Apps Scriptをデプロイする
Google Apps Scriptにアクセスして新しいプロジェクトを作成します
code.gsの内容全体をコピーし、スクリプトエディタに貼り付けます。「デプロイ」>「新しいデプロイ」をクリックします
展開タイプとして「Webアプリ」を選択します
次の設定を構成します。
実行者: 私
アクセスできるユーザー: 誰でも
「デプロイ」をクリック
プロンプトが表示されたら、アプリを確認して Gmail アカウントへのアクセスを許可します。
デプロイURLをコピーし、セキュリティのためにランダムなAPIキーを生成します
注: このスクリプトにはGmailへのアクセス権限が必要です。スクリプトを初めてデプロイして実行する際、Googleからこれらの権限の確認と付与を求められます。以下の点にご注意ください。
「権限を確認」をクリックします
Googleアカウントを選択してください
警告が表示された場合は「詳細設定」をクリックしてください
「[プロジェクト名] に移動 (安全ではありません)」をクリックします。
「許可」をクリックして、必要なGmail権限を付与します
Claude Desktop 構成ファイルを開きます:
~/Library/Application Support/Claude/claude_desktop_config.json
これは、Claude デスクトップ メニューから見つけることができます。
クロードデスクトップを開く
MacのメニューバーでClaudeをクリック
「設定」をクリック
「開発者」をクリック
設定に以下を追加します。
注: YOUR_DEPLOYMENT_URLとYOUR_API_KEY実際の値に置き換えてください。
Related MCP server: Gmail Plugin MCP Server
開発者向け
前提条件
Node.js 18+ (
brew install nodeでインストール)Gmailアカウント
Google Apps スクリプト
Claude Desktop ( https://claude.ai/desktopからインストール)
tsx (
npm install -g tsxでインストール)
インストール
開発構成
Claude Desktop がインストールされ、実行されていることを確認してください。
まだインストールしていない場合は、tsx をグローバルにインストールします。
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 にアクセスできるようにするために役立ちます。