mcpField
G
gmail

gmail

ローカル
github.com/markswendsen-codeコミュニケーション028 週間前に更新

gmail について

gmail は、AI エージェントが Gmail でメールを読んだり、検索したり、送信したりするための MCP サーバーです。受信トレイの一覧表示や、過去のメールを踏まえた返信にも対応します。

主な機能

  1. 01Gmail 検索構文でのメール検索
  2. 02メール全文の読み取り
  3. 03受信トレイの最近のメール一覧
  4. 04CC と BCC を含むメール送信

活用シーン

  1. 01新着メールを整理し、緊急のメールを特定
  2. 02返信前に過去の会話を検索して文脈を確認
  3. 03ユーザーに代わって定型メールを作成、送信

MCP 対応

Gmail の検索、読み取り、受信トレイ一覧、送信のツールを MCP クライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"markswendsen-code-gmail": {
"command": "npx",
"args": [
"-y",
"@striderlabs/mcp-gmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"GOOGLE_REFRESH_TOKEN": "<GOOGLE_REFRESH_TOKEN>"
}
}
}
}
起動コマンドnpx -y @striderlabs/mcp-gmail
設定が必要な環境変数
GOOGLE_CLIENT_IDGoogle OAuth 2.0 Client ID from Google Cloud Console
GOOGLE_CLIENT_SECRETシークレットGoogle OAuth 2.0 Client Secret
GOOGLE_REFRESH_TOKENシークレットGoogle OAuth 2.0 Refresh Token for the user's Gmail account

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@striderlabs/mcp-gmail0.1.0

ツール

4

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
ccstringいいえCC の宛先(カンマ区切り、任意)
tostringはい受信者のメールアドレス
bccstringいいえBCC の宛先(カンマ区切り、任意)
bodystringはいメール本文(プレーンテキスト)
subjectstringはいメールの件名

詳細

@striderlabs/mcp-gmail

AI エージェントが Gmail 経由でメールを送信、閲覧、検索できる MCP サーバーです。

エージェント向け

エージェントはこのコネクターを使って、人間に代わって自律的にメールを処理します。重要なメッセージの閲覧、情報の検索、配慮の行き届いた返信の作成、連絡の送信を行います。

エージェントのワークフロー例:

  1. メールを仕分ける: エージェントが新着メッセージを読み、重要なものを要約し、緊急の項目にはユーザーの注意を促すフラグを付けます
  2. 定型的な質問に回答する: エージェントがメールの履歴を検索して情報を探し、過去の会話の文脈を踏まえて返信を作成します
  3. ユーザーに代わって送信する: エージェントがユーザーの意図(「チームに、遅れることを伝えて」)に基づいてビジネスメールを作成して送信し、会話にコピーを記録します

使用例:

ユーザー:「第 2 四半期の予算案について送ったメールに、誰か返信しましたか?」

エージェント:

  1. gmail_search → "to:me subject:budget"
  2. gmail_read → 各メッセージを読む
  3. 要約を返す:「Sarah は月曜日に了承の返信をしました。Mark は修正を求めています。Finance からはまだ連絡がありません。」

その後、エージェントは自動的に Finance へのフォローアップメールを作成し、送信前に承認を求めることがあります。

インストール

npx @striderlabs/mcp-gmail

設定

MCP クライアントの設定(例:Claude Desktop)に追加します。

{
  "mcpServers": {
    "strider-gmail": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-gmail"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

利用可能なツール

gmail_send

ユーザーの Gmail アカウントからメールを送信します。

パラメーター:

  • to(必須):受信者のメールアドレス
  • subject(必須):メールの件名
  • body(必須):メール本文
  • cc(任意):CC の宛先
  • bcc(任意):BCC の宛先
gmail_search

Gmail の検索構文を使ってメールを検索します。

パラメーター:

  • query(必須):Gmail の検索クエリー(例:"from:[email protected]")
  • maxResults(任意):結果の最大数(デフォルト:10)
gmail_read

指定したメールの全文を読みます。

パラメーター:

  • messageId(必須):Gmail のメッセージ ID
gmail_list

受信トレイの最近のメールを一覧表示します。

パラメーター:

  • maxResults(任意):一覧表示するメールの最大数(デフォルト:10)
  • label(任意):ラベルで絞り込みます(例:"INBOX"、"UNREAD")

Google OAuth 認証情報の取得

  1. Google Cloud Console にアクセスします
  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
  3. Gmail API を有効にします
  4. OAuth 2.0 認証情報を作成します
  5. OAuth playground またはアプリを使って、リフレッシュトークンを取得します

レスポンス形式

すべてのツールは構造化された JSON を返します。

{
  "success": true,
  "messageId": "...",
  "message": "Email sent successfully"
}

Strider Labs の一部

Strider Labs は AI エージェント向けのアクション実行インフラストラクチャを構築しています。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。