Gmail

AllMCP provides your agents with a complete set of Gmail tools: read and search emails, send messages and drafts with threading support, manage labels, and receive real-time push notifications.

All providers How connecting works

---

Point your client at AllMCP

Connect your MCP client to the AllMCP endpoint and authenticate with your API key.

https://go.allmcp.co/mcp/

Send your key on every request using either header:

X-API-Key: allmcp_xxx

Authorization: Bearer allmcp_xxx

If you run agents for multiple customers, append ?user_id=... (and optionally ?org_id=...) to the endpoint URL to keep each customer’s mailbox session isolated.

---

Available Categories & Tools

Gmail tools in AllMCP are organized into four functional categories:

1. messages

• gmail_list_messages: Search messages using standard Gmail query syntax (from:, to:, has:attachment, is:unread).
• gmail_get_message: Retrieve full email details including RFC 2822 headers, body (plain text & HTML), thread ID, and attachment metadata.
• gmail_send_message: Send emails with support for to, subject, body, html_body, cc, bcc, and threading (thread_id).
• gmail_trash_message: Move messages to Trash.
• gmail_untrash_message: Restore messages from Trash.

2. labels

• gmail_list_labels: List all system and user labels with unread message counts.
• gmail_modify_labels: Add or remove labels on messages (e.g., mark as read/unread, star, archive).

3. drafts

• Manage draft messages before sending.

4. webhooks

• gmail_watch: Set up push notifications to a Google Cloud Pub/Sub topic for incoming emails.
• gmail_stop_watch: Disable active mailbox push subscriptions.

---

OAuth2 Scopes

When connecting, the user will be asked to authorize:

• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/gmail.modify
• https://www.googleapis.com/auth/gmail.send