概要
AI に Gmail で作業させます。Gmail の検索構文によるメールボックスの検索、メッセージとスレッドの読み取り、既読にする、アーカイブ、スター付け、ラベル付け、メールの作成、返信、送信、事前に確認できる下書きの保存ができます。個人の Gmail と Google Workspace に対応し、ご自分の Google OAuth クライアントを使います。
ガイド付きセットアップ
Gmail を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Gmail を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Gmail のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Gmail をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Gmail + Microsoft Copilot
AI に Gmail で作業させます。Gmail の検索構文によるメールボックスの検索、メッセージとスレッドの読み取り、既読にする、アーカイブ、スター付け、ラベル付け、メールの作成、返信、送信、事前に確認できる下書きの保存ができます。個人の Gmail と Google Workspace に対応し、ご自分の Google OAuth クライアントを使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET
ステップ 1 — 認証情報を取得
- console.cloud.google.com を開き、プロジェクトを選択または作成してから、APIs & Services → Library で Gmail API を有効にします。
- APIs & Services → OAuth consent screen を開きます。メールボックスが Google Workspace にある場合は Internal（最も簡単です）、それ以外は External を選びます。External の場合は公開ステータスを In production にしてください。アプリが Testing のままだと、Google は 7 日後にリフレッシュトークンを取り消し、コネクターは毎週動かなくなります。
- APIs & Services → Credentials → Create credentials → OAuth client ID を開き、アプリケーションの種類に Web application を選んで、承認済みのリダイレクト URI に
https://cloud.anythingmcp.com/api/mcp-oauth/callbackを追加します。AnythingMCP をセルフホストしている場合は、代わりにhttps://your-anythingmcp-host/api/mcp-oauth/callbackを入力します。 - クライアント ID を
GOOGLE_CLIENT_IDに、クライアントシークレットをGOOGLE_CLIENT_SECRETに貼り付けて、コネクターをインストールします。 - コネクターのページで Authorize with Provider をクリックし、AI に使わせたい Gmail アカウントでサインインします。リフレッシュトークンは暗号化して保存され、アクセストークンは自動的に更新されます。
- AI に
gmail_get_profileを実行させます。コネクターが使っているアドレスと、メールボックス内のメッセージ数とスレッド数が返ります。
すべての Google コネクターに 1 つの Google クライアント: 同じ Cloud プロジェクトと OAuth クライアントで、Gmail、Google Calendar、Google Drive、Google Sheets、Google Docs、Google Tasks、Search Console、Analytics、Ads のすべての Google コネクターを使えます。そのプロジェクトで各 API を有効にし、同じクライアント ID とシークレットを使い回して、コネクターごとに一度ずつ承認してください。各コネクターは自分に必要な権限だけを求めます。
Google の確認（検証）: Google は、このコネクターが使う Gmail の権限（gmail.modify、読み取り専用の設定では gmail.readonly）を制限付き（restricted）に分類しています。Cloud プロジェクトを所有する Workspace 組織のアカウントだけが使う Internal アプリは確認不要で、企業にとってはこれが最も手早い方法です。他の人が使う External アプリでは「Google hasn't verified this app」という警告が表示され、Google の確認を通過するまでユーザー数が 100 人に制限されます。制限付きの権限の場合、この確認にはセキュリティ評価も含まれます。個人の Gmail アカウント 1 つだけで使うなら、自分だけが使う In production の External アプリは警告を先に進めば使えます。
権限: コネクターは https://www.googleapis.com/auth/gmail.modify を求めます。メールの読み取り、ラベルの変更（既読にする、アーカイブ、スター付け）、下書きの作成、メールの送信ができる権限です。承認した Google アカウントとして動作し、そのアカウントに見えるものだけが見えます。完全に削除することはできません。
実際にメールを送るツール: gmail_send_message（新しいメール）、gmail_reply（スレッド内の返信）、gmail_send_draft（既存の下書きを書かれたとおりに送信）は、サインインしたアドレスからすぐに送信し、送信は取り消せません。gmail_create_draft は下書きを保存するだけで（スレッド内の返信の下書きも可能）、確認と送信は Gmail で行います。はっきり送信を頼んでいない場合は下書きを優先するよう、コネクターが AI に指示しています。1 通のメッセージの宛先は最大 500 件です。AI が読むメールに、何かを送信させようとする文章が含まれている可能性もあります。AI にはメールの準備だけをさせたい場合は、gmail_send_message、gmail_reply、gmail_send_draft を無効にし、下書きはご自分で送信してください。
読み取り専用の設定: コネクターの OAuth 設定でスコープを https://www.googleapis.com/auth/gmail.readonly に変更し、もう一度承認してから、gmail_modify_message_labels、gmail_modify_thread_labels、gmail_create_draft、gmail_send_draft、gmail_send_message、gmail_reply を無効にします。
メールの読み取りと整理: 検索には Gmail の検索ボックスと同じ構文を使います。たとえば from:[email protected] is:unread newer_than:7d や has:attachment です。メッセージとスレッドはプレーンテキストで返ります（HTML だけのメールはテキストに変換されます）。非常に長い本文は 20,000 文字、スレッド全体では 100,000 文字で切り詰められます。添付ファイルは名前、種類、サイズが一覧表示されますが、ダウンロードはされません。既読にする、アーカイブ、スター付け、ラベルでの分類は、1 通のメッセージまたはスレッド全体へのラベル変更として行います。
レート制限: Gmail では 1 ユーザーあたり毎分 6,000 クォータ単位まで使えます。検索は 5、メッセージの読み取りは 20、スレッドは 40、メッセージや下書きの送信は 100 単位です。上限を超えると Gmail は 429（または 403 userRateLimitExceeded）を返します。1 分待ってから再試行してください。
よくあるエラー: 401 は承認の期限切れまたは取り消しを示します（同意画面が Testing のままだと 7 日後に必ず起きます）。もう一度 Authorize with Provider をクリックしてください。403 accessNotConfigured は、Cloud プロジェクトで Gmail API が有効になっていないことを示します。403 insufficientPermissions または ACCESS_TOKEN_SCOPE_INSUFFICIENT は、スコープがその操作を許可していないこと（読み取り専用の設定でラベルを変更しようとした場合など）を示します。404 は、その ID がこのメールボックスに存在しないことを示します。下書き ID（r- で始まります）はメッセージ ID ではありません。400 invalidArgument は、たいてい存在しないラベル ID を示します。自分で作ったラベルの ID は Label_12 のような形式で、gmail_list_labels で確認できます。
このコネクターは添付ファイルの送信やダウンロード、元の添付ファイル付きの転送、ゴミ箱への移動や削除は行わず、フィルタ、設定、送信元エイリアス、他の人のメールボックスも扱いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Microsoft Copilot にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name（例:
AnythingMCP）、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Gmailのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
gmail_get_profile | Return the Gmail account the connector works with: its email address, the total number of messages and threads in the mailbox, and the… |
gmail_list_messages | Search or list messages in the mailbox with Gmail search syntax and optional label filters |
gmail_get_message | Get one message by id, decoded: sender, recipients, subject, date, Message-ID and References, labels and the body as plain text (HTML-only… |
gmail_list_threads | Search or list conversations (threads) with Gmail search syntax and optional label filters |
gmail_get_thread | Get one conversation by thread id with all its messages in order, each decoded like gmail_get_message: sender, recipients, subject, date… |
gmail_list_labels | List all labels of the mailbox, system labels (INBOX, UNREAD, STARRED, SENT, SPAM, TRASH, categories) and the user's own, with id, name and… |
gmail_get_label | Get one label by id with its message and thread counts, total and unread, plus its visibility settings and colour |
gmail_modify_message_labels | Add and remove labels on one message: mark it read (remove UNREAD) or unread (add UNREAD), archive it (remove INBOX), star it (add STARRED)… |
gmail_modify_thread_labels | Add and remove labels on every message of a conversation at once, e.g. archive a whole thread (remove INBOX) or mark it read (remove UNREAD) |
gmail_list_drafts | List the drafts in the mailbox, optionally filtered with Gmail search syntax |
gmail_get_draft | Get one draft by draft id with its message decoded: recipients, subject and the body as plain text, to check it before it is sent with… |
gmail_create_draft | Save a new email as a draft in the mailbox without sending it, so the user can review it in Gmail; send it later with gmail_send_draft |
gmail_send_draft | Send an existing draft to its recipients exactly as it is written |
gmail_send_message | Write and send a new email from the signed-in Gmail account right away |
gmail_reply | Send a reply inside an existing conversation |
gmail_get_attachment | Download one attachment of a message by its attachmentId, from the attachments list of gmail_get_message, gmail_get_thread or… |
プロンプトの例
- 「過去 3 日間の未読メールのうち、まだ私の返信が必要なものはどれですか。それぞれ 1 文で要約してください。」
- 「[email protected] から届いた見積もりに関する最新のメールを探し、新しい日程を承諾する返信の下書きを作ってください。送信はせず、Gmail で私が確認します。」
- 「受信トレイにある 1 週間以上前のニュースレターをすべて既読にしてアーカイブし、アーカイブしたものを一覧にしてください。」
- 「10 月 1 日以降の添付ファイル付きメールのうち請求書らしいものを、差出人、日付、件名、ファイル名とともに一覧にしてください。」
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?