ヘッドレス Gmail MCP サーバー

「ヘッドレス Gmail」MCP サーバーは何をするのか？

ヘッドレス Gmail MCP サーバーは、Gmail アカウントへのメール送受信や取得をシームレスに行える Model Context Protocol (MCP) サーバーです。ローカルの認証情報やトークン設定が不要で、ヘッドレスかつリモート運用向けに設計されています。クライアントは OAuth フローを独立して完結でき、認証情報も安全にコンテキストとして渡せるため、ローカルファイルやブラウザを一切使わず、完全なコンテナ・クラウド環境でも利用可能です。マーケティング自動化や通知システムなど、Gmail への集中的で信頼性の高いアクセスが必要なワークフローに最適で、MCP インターフェースを通じてメール管理やAI開発パイプラインへの統合が簡単に行えます。

プロンプト一覧

リポジトリ内に特定のプロンプトテンプレートは記載されていません。

リソース一覧

利用可能なドキュメントやコードには明示的な MCP リソースの記述はありません。

ツール一覧

• 最新メールの取得
  Gmail アカウントから最新メールを取得し、本文の最初の1000文字を返します。
• メール本文の完全取得
  オフセットパラメータによる1000文字単位のチャンクで、メール本文の全内容を取得できます。大きなメールにも対応。
• メール送信
  接続済み Gmail アカウントからメールを送信します。
• アクセストークンのリフレッシュ
  トークンの自動更新を独立して行い、常に安全なアクセスを維持します。

この MCP サーバーのユースケース

• 自動メール通知
  AI エージェントや自動化プラットフォームと連携し、手動操作なしでリアルタイムなメール通知・アラートを送信できます。
• Gmail 受信箱の監視
  最新メールを取得・処理し、レスポンスやトリアージ、情報抽出など後続ワークフローを自動化できます。
• マーケティングキャンペーン自動化
  MCP を活用し、個別化したマーケティングメールをプログラムで大量送信。認証情報を分離したスケーラブルな運用が可能です。
• シームレスな API 連携
  開発環境や他の MCP 対応プラットフォームへ Gmail 操作を組み込み、ローカル認証情報の管理や露出なしに安全に運用できます。
• リモート/クラウドメール管理
  Docker やリモート環境でも Gmail アカウントを管理でき、ローカル依存のない安全なヘッドレス運用を実現します。

セットアップ方法

Windsurf

1. Node.js と Windsurf をインストールしてください。
2. 設定ファイル（例: windsurf.json）を開きます。
3. mcpServers セクションにヘッドレス Gmail MCP サーバーを追加します:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存して Windsurf を再起動します。
5. Windsurf ダッシュボードでサーバー稼働を確認します。

API キーのセキュリティ確保
認証情報は環境変数で安全に渡してください:

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": ["@baryhuang/mcp-headless-gmail@latest"],
      "env": {
        "GMAIL_CLIENT_ID": "...",
        "GMAIL_CLIENT_SECRET": "...",
        "GMAIL_ACCESS_TOKEN": "...",
        "GMAIL_REFRESH_TOKEN": "..."
      }
    }
  }
}

Claude

1. Claude をインストールし、Node.js も利用可能な状態にしてください。
2. 設定ファイル（例: claude.json）を編集します。
3. サーバーを追加します:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存して Claude を再起動します。
5. Claude のインターフェースからサーバーステータスを確認します。

API キーのセキュリティ確保
上記と同様に env キーで認証情報を安全に挿入してください。

Cursor

1. Cursor がインストール済み・最新であることを確認します。
2. Cursor の設定または設定ファイルを開きます。
3. MCP サーバーを挿入します:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存して Cursor を再起動します。
5. MCP サーバーが検出されているか確認します。

API キーのセキュリティ確保
認証情報は前述の env セクションで設定してください。

Cline

1. Cline と依存パッケージをインストールします。
2. Cline の設定ファイルを開きます。
3. MCP サーバーを追加します:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存して Cline を再起動します。
5. Cline のツールからサーバー接続を確認します。

API キーのセキュリティ確保
認証情報は前述の通り、環境変数で設定してください。

この MCP をフロー内で使う方法

FlowHunt で MCP を利用する

FlowHunt のワークフローに MCP サーバーを組み込むには、まず MCP コンポーネントをフローに追加し、AI エージェントと接続します。

MCP コンポーネントをクリックして設定パネルを開き、system MCP 設定欄に以下の JSON 形式で MCP サーバー情報を入力します:

{
  "headless-gmail": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AI エージェントがこの MCP の全機能・ツールを利用できるようになります。“headless-gmail” は実際の MCP サーバー名（例: “github-mcp” や “weather-api” 等）に、URL もご自身の MCP サーバーURLに置き換えてください。

概要

所感

公開情報に基づくと、ヘッドレス Gmail MCP サーバーは非常に用途が明確で導入も簡単、主要プラットフォーム向けの手順も充実し、Docker/ヘッドレス運用も強力です。一方でプロンプトテンプレートやリソース定義が明示されていないため、一部高度な MCP 機能には制限があります。シンプル・安全・実用性が際立つ自動化向けサーバーで、目的用途には十分実用的かつ信頼できますが、他の MCP サーバーと比べると機能面でややシンプルです。

MCP スコア