# Gmail MCP for AI Agents | FlyMy.AI

> Gmail MCP for Claude, Codex and Cursor through FlyMy.AI. Gmail is Google's email service, featuring spam protection, search functions, and seamless...

Page: https://flymy.ai/mcp/gmail/

MCP / Messaging

# Gmail MCP

Gmail is Google's email service, featuring spam protection, search functions, and seamless integration with other G Suite apps for productivity. Connect it to Claude, Codex, Cursor or any MCP client through one FlyMy.AI MCP.

[Connect Gmail](https://flymy.ai/mcp/gmail/#connect) [What it can do](https://flymy.ai/mcp/gmail/#actions)

Sign in once, 23 actions, Messaging

Ask your agent

```
Find up to 10 unread Gmail messages from the past week and show their senders and subjects.
```

Paste it into an assistant connected to FlyMy.AI. The agent picks the actions.

## What Gmail MCP can do

23 actions in the FlyMy.AI catalog, the most used first. Your agent finds them through search_tools and calls the one the task needs.

| Action | What it does |
|---|---|
| `GMAIL_CREATE_EMAIL_DRAFT` | Creates a gmail email draft, supporting to/cc/bcc, subject, plain/html body (ensure `is html=true` for html), attachments, and threading. |
| `GMAIL_GET_PROFILE` | Retrieves key gmail profile information (email address, message/thread totals, history id) for a user. |
| `GMAIL_SEND_DRAFT` | Sends the specified, existing draft to the recipients in the to, cc, and bcc headers. |
| `GMAIL_ADD_LABEL_TO_EMAIL` | Adds and/or removes specified gmail labels for a message; ensure `message id` and all `label ids` are valid (use 'listlabels' for custom label ids). |
| `GMAIL_CREATE_LABEL` | Creates a new label with a unique name in the specified user's gmail account. |
| `GMAIL_DELETE_DRAFT` | Permanently deletes a specific gmail draft using its id; ensure the draft exists and the user has necessary permissions for the given `user id`. |
| `GMAIL_DELETE_MESSAGE` | Permanently deletes a specific email message by its id from a gmail mailbox; for `user id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated... |
| `GMAIL_FETCH_EMAILS` | Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval. |
| `GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID` | Fetches a specific email message by its id, provided the `message id` exists and is accessible to the authenticated `user id`. |
| `GMAIL_FETCH_MESSAGE_BY_THREAD_ID` | Retrieves messages from a gmail thread using its `thread id`, where the thread must be accessible by the specified `user id`. |
| `GMAIL_GET_ATTACHMENT` | Retrieves a specific attachment by id from a message in a user's gmail mailbox, requiring valid message and attachment ids. |
| `GMAIL_GET_CONTACTS` | Fetches contacts (connections) for the authenticated google account, allowing selection of specific data fields and pagination. |

**Show all 23 actions**

| Action | What it does |
|---|---|
| `GMAIL_GET_PEOPLE` | Retrieves either a specific person's details (using `resource name`) or lists 'other contacts' (if `other contacts` is true), with `person fields` specifying the data to return. |
| `GMAIL_LIST_DRAFTS` | Retrieves a paginated list of email drafts from a user's gmail account. |
| `GMAIL_LIST_LABELS` | Retrieves a list of all system and user-created labels for the specified gmail account. |
| `GMAIL_LIST_THREADS` | Retrieves a list of email threads from a gmail account, identified by `user id` (email address or 'me'), supporting filtering and pagination. |
| `GMAIL_MODIFY_THREAD_LABELS` | Adds or removes specified existing label ids from a gmail thread, affecting all its messages; ensure the thread id is valid. |
| `GMAIL_MOVE_TO_TRASH` | Moves an existing, non-deleted email message to the trash for the specified user. |
| `GMAIL_PATCH_LABEL` | Patches the specified label. |
| `GMAIL_REMOVE_LABEL` | Permanently deletes a specific, existing user-created gmail label by its id for a user; cannot delete system labels. |
| `GMAIL_REPLY_TO_THREAD` | Sends a reply within a specific gmail thread using the original thread's subject, requiring a valid `thread id` and correctly formatted email addresses. |
| `GMAIL_SEARCH_PEOPLE` | Searches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'other contacts'. |
| `GMAIL_SEND_EMAIL` | Sends an email via gmail api using the authenticated user's google profile display name, requiring `is html=true` if the body contains html and valid `s3key`, `mimetype`, `name` for any attachment. |

## Ask your agent

Requests to paste as they are. Each one runs on the actions named under it.

**“Find up to 10 unread Gmail messages from the past week and show their senders and subjects.”** uses `GMAIL_FETCH_EMAILS`

**“Show up to 10 labels from my connected Gmail account, with their names and IDs.”** uses `GMAIL_LIST_LABELS`

**“Read this Gmail thread and summarize its open questions in five bullets.”** uses `GMAIL_FETCH_MESSAGE_BY_THREAD_ID`

## Connect Gmail in a minute

One MCP for every integration. Add it once, then every MCP in the catalog is a request away.

1. 01 ### Add FlyMy.AI Add the FlyMy.AI MCP to your assistant with one of the commands below and sign in. No key to copy.
2. 02 ### Sign in to Gmail Open the Gmail [connection settings](https://app.flymy.ai/mcp-configs#gmail) and sign in once. Your agent then works as your account; the token stays with FlyMy.AI, never in a prompt or a chat.
3. 03 ### Ask Paste a request from this page. Every run shows what it cost.

Claude Code

```
claude mcp add --transport http flymyai https://mcp-agents.flymy.ai/mcp
```

Then run /mcp in Claude Code and sign in.

Codex

```
codex mcp add flymy --url https://mcp-agents.flymy.ai/mcp
```

Then run codex mcp login flymy to sign in.

claude.ai and Claude Desktop

```
https://mcp-agents.flymy.ai/mcp
```

Settings, Connectors, Add custom connector: paste this URL.

## Pay per run

FlyMy.AI bills the run: the model and the tool's seconds. Calls go to your own Gmail account, under its plan and limits. No seats and no minimum.

[See usage pricing →](https://flymy.ai/pricing/)

## More Messaging MCPs

Email, chat, SMS and notifications.

### Telegram Bot

Telegram bot send/receive - closest to an SMS bot

6 actions / your API key

Link: https://flymy.ai/mcp/telegram-bot/

### Telegram

Personal Telegram via your own account - DM/read anyone, resolve @username/contacts

23 actions / phone login

Link: https://flymy.ai/mcp/telegram/

### Mail

Transactional email via FlyMyAI relay

1 action / no key

Link: https://flymy.ai/mcp/mail/

### Slack Bot

Slack Bot: post and read as the FlyMyAI bot in channels it was added to

8 actions / sign in

Link: https://flymy.ai/mcp/slack-bot/

### Slack

Slack as you: search messages and files, read and post in channels and DMs, threads, files, canvases, lists, reminders, user groups

120 actions / sign in

Link: https://flymy.ai/mcp/slack/

### 2Chat

2Chat provides a programmable API for integrating WhatsApp and other text channels, enabling developers to send and receive messages, manage groups, and...

5 actions / your API key

Link: https://docs.flymy.ai/mcp/apps/2chat

## Go to the source

[Gmail in the docs →](https://docs.flymy.ai/mcp/gmail), [Gmail connection settings →](https://app.flymy.ai/mcp-configs#gmail), [Gmail website →](https://mail.google.com), [Every MCP in the catalog →](https://flymy.ai/mcp/#catalog), [Usage pricing →](https://flymy.ai/pricing/)

From the FlyMy.AI platform catalog of 2026-10-31: name, description, actions and setup as the platform lists them. Examples are requests to paste, not recorded runs.

---

For agents: the FlyMyAI operating guide (sign up, connect, run models, tools and agents) is https://flymy.ai/skill.md, and https://flymy.ai/llms.txt lists the other pages and the documentation.
