# How to Give Your Grok Bot an Email Inbox

> Give your Grok Bot an email inbox: claim its mail.grokbot.com address, connect Gmail or Outlook, or add an agent email provider such as AgentMail.

A Grok Bot can claim its own email address in a minute. For sign-ups, receipts and verification codes, that address is often enough. When you need more than one inbox, your own domain, or an inbox that other apps can also use, connect Gmail or Outlook, or add an agent email provider as a custom connector. This guide shows the three ways, with the steps and the limits of each.

## Does Grok Bot have its own email address?

Yes. Each Grok Bot account can claim one address on `mail.grokbot.com`, for example `yourname@mail.grokbot.com` ([xAI: Use the computer and apps](https://docs.x.ai/grok-bot/computer-and-apps#give-your-bots-an-email-address)). The address belongs to you, so all your Bots can use it.

Claim the address in one of two ways:

1. Ask your Bot: "Get yourself an email address." The Bot asks for a name and shows an approval card. The Bot claims nothing until you approve.
2. On desktop, open **Connect apps** and choose **Email**. Type a name in **Choose a name**, then choose **Create address**. On the phone, open **Settings** > **Connect apps** > **Email**.

A name can have up to 64 characters: lowercase letters, digits and the symbols `.`, `-` and `_`. It must start and end with a letter or a digit. You cannot use reserved words, such as support, admin, billing and grok. You cannot rename or delete the address, so choose the name carefully.

The address also takes plus aliases. Mail to `yourname+receipts@mail.grokbot.com` goes to the same inbox as `yourname@mail.grokbot.com`. Give each service its own alias. A routine can then watch only the mail to one alias.

With the address, a Bot can:

- sign up for services and get the verification code or link, with your OK;
- collect receipts, newsletters and reports, and summarize them;
- draft email and replies for you;
- forward an email with its formatting and attachments (Grok Bot 0.75.2 or later);
- start a routine when email arrives.

These rules from the [Grok Bot help page on agent email](https://cursor.com/help/grok-bot/agent-email) shape how you use it:

| Rule | What it means for you |
|---|---|
| One address for each account | All your Bots use it. Plus aliases go to the same inbox. |
| No inbox view | Ask the Bot, for example "What arrived in your inbox today?" There are no new-mail notifications. |
| Attachment limits | Up to 10 attachments in each message, 10 MB each and 25 MB in total. The Bot skips other attachments. |
| Spam and virus scan | Grok Bot keeps mail that fails the scan without its body or attachments. That mail never starts a routine. |
| Your own chats only | The address does not work in Slack threads or in chats with other people. A Team Bot has no team address. |
| Teams | On a Cursor team, agent email is off until an admin turns on **Agent Email**. |
| Tied to your account | If you delete your Grok Bot account, Grok Bot deletes the mail and attachments. Nobody else gets the address later. |

## How do I send an email with Grok Bot?

Ask in the chat, for example: "Send an email from your inbox to anna@example.com with the subject Project brief and attach brief.pdf."

Who approves the email depends on who started the work ([xAI: Approvals and privacy](https://docs.x.ai/grok-bot/approvals-security-and-privacy)):

- When you ask for an email in chat, it goes out when Auto Review allows it. If Auto Review needs you, you see an approval card first.
- An email from a routine, or from other work that you did not start with that request, stays a draft until you press **Send**. There is no setting for unattended sending.
- A forward, or an email with an attachment that Auto Review cannot fully read, always waits for your OK.

To approve each email yourself, add a rule:

1. Open **Settings** > **General**.
2. Under the **Auto-review** switch, find **Custom Rules**.
3. Under **When Grok Bot wants to:**, type `send an email`.
4. Under **It should:**, choose **Ask first**.
5. Press **Add Rule**.

An email from the Bot's address can have up to 50 recipients in To, Cc and Bcc together. Newsletters and first-contact emails go to one recipient in each message, with a one-click unsubscribe link. After a bounce, an unsubscribe or a spam report, the Bot stops email to that address and tells you.

## How do I make the Bot act on new email?

New mail does not wake a Bot. A routine (a saved task that a Bot runs on a schedule or on an event) must watch the inbox. A routine can watch mail from anyone, from one address such as `billing@example.com`, or from a domain such as `*@example.com`. By default, it runs only for senders that pass standard email authentication checks. It cannot filter by subject ([Grok Bot help: Routines](https://cursor.com/help/grok-bot/routines)).

Ask the Bot in chat:

> When an email arrives from *@supplier.com, read the attached invoice. Tell me the amount and the due date, and draft a reply that says we received it.

Then test the routine:

1. Open the routine and read **When to run**. Make sure that it shows the sender filter that you want.
2. Choose **Test** to run the routine now. A test does real work, so use a test email.
3. Read the draft reply. If it is correct, press **Send**.

An approval card from a routine expires after 30 minutes. A routine that runs often uses more of your weekly usage, so keep the sender filter narrow.

How an invoice email moves through a routine:

![An invoice email starts a routine, the routine drafts a reply, and the reply goes out after you press Send](/assets/en/blog/give-grok-bot-email-inbox/diagram_sender-address-routine.png)

## How do I forward only some of my mail to the Bot?

You do not have to connect your personal mailbox. In Gmail, a filter can forward only the mail that the Bot needs to the Bot's own address ([Gmail Help: Automatically forward Gmail messages](https://support.google.com/mail/answer/10957)):

1. In Gmail on a computer, open **Settings** > **See all settings** > **Forwarding and POP/IMAP**.
2. Click **Add a forwarding address** and type the Bot's address.
3. Ask the Bot: "Find the email from Google and give me the verification link." Open the link.
4. In the Gmail search box, open the search options and type the sender, for example `invoices@supplier.com`.
5. Click **Create filter**, select **Forward it** and choose the Bot's address.
6. Click **Create filter** again.

Gmail then forwards only the mail from that sender. Other mail stays in your own inbox.

## How do I connect Gmail or Outlook instead?

The **Email** app gives the Bot a new address. The Gmail and Outlook apps connect a mailbox that you already have. Use them when the mail must come from your own domain, for example a Google Workspace address.

1. Open **Connect apps** in the sidebar.
2. Search for **Gmail** or **Outlook** and add the app.
3. When Grok Bot asks you to **Authorize**, sign in to the account in your browser.
4. Make sure that the app shows under **Installed**.

With Gmail, the Bot can search and read mail, draft and send, and apply labels ([Grok Bot help: Connect apps](https://cursor.com/help/grok-bot/connect-apps)). Know these limits before you connect it:

- Gmail connects one mailbox at a time. To use another mailbox, disconnect the first one.
- Apps are account-wide. Every Bot on your account can read the connected mailbox.
- A company Google account can block the connection until a Google admin trusts the app **Grok**.
- A work Microsoft 365 account can stop Outlook until your Microsoft 365 admin approves the app.

If your Bots must not read your personal mail, create a separate Google account for them and connect that account.

## How do I add an agent email provider?

An agent email provider gives an AI agent inboxes through an API. Use one when you need several inboxes, for example one for each client, or an inbox that your own code and other AI apps also use.

AgentMail is one example. It has a hosted MCP server at `https://mcp.agentmail.to/mcp` ([AgentMail MCP docs](https://docs.agentmail.to/integrations/mcp)). MCP (Model Context Protocol) is a standard way for AI apps to use outside tools. AgentMail's [Grok Bot guide](https://agentmail.to/docs/integrations/grokbot) says that AgentMail is in the Grok Bot app catalog. Search for it in **Connect apps** first. If you do not find it, add it as a custom connector:

1. Create an API key in the [AgentMail console](https://console.agentmail.to) under **Settings** > **API Keys**.
2. In the Grok Bot desktop app, open **Connect apps** and choose **Add a custom connector**.
3. In **Name**, type `AgentMail`. For **Type**, choose **Remote HTTPS**.
4. In **Server URL**, type `https://mcp.agentmail.to/mcp`.
5. Under **HTTP headers**, add the header `x-api-key` with your API key as its value.
6. Choose **Add plugin**.
7. In a new chat, ask: `Create an AgentMail inbox called acme-invoices.`

The custom connector steps come from [xAI's guide to apps](https://docs.x.ai/grok-bot/computer-and-apps). The Bot can then list, read, send, reply to and forward mail in each inbox. To approve each email that it sends through AgentMail, add an **Ask first** rule for that action, as for the Bot's own address.

The email routine trigger of Grok Bot watches only the Bot's own address. For an AgentMail inbox, run the routine on a schedule, for example "every weekday at 9:00". AgentMail inboxes can also use your own domain ([AgentMail: custom domains](https://agentmail.to/docs/custom-domains)).

## Compare the three ways

| You need | Bot's own address | Gmail or Outlook app | Agent email provider |
|---|---|---|---|
| Setup | One approval card | Sign in to your account | API key and a custom connector |
| Number of inboxes | One, with plus aliases | One Gmail mailbox at a time | One for each client or task |
| Domain | `@mail.grokbot.com` only | Your domain, with Google Workspace or Microsoft 365 | Your domain, with a custom domain |
| Start work on new mail | Routine with a sender filter | Routine on a schedule | Routine on a schedule |
| Use from other apps | No | Yes, apps that you connect to the same mailbox | Yes, through the API and MCP |

For most people, we recommend a separate Gmail account, connected through the Gmail app. It is free, other AI apps can use it too, and your personal email stays out of reach. The Bot's own address is enough when only the Bot uses the mail. [Email inboxes for AI agents and people](/email-for-ai-agents/) lists other services, with prices.

How to choose:

![How to choose an inbox for a Grok Bot: the Bot's own address, a Gmail or Outlook app, or an agent email provider](/assets/en/blog/give-grok-bot-email-inbox/diagram_choose-inbox.png)

## Prompts to try

- `What arrived in your inbox today? List the sender, the subject and the attachments.`
- `Find the receipt from last week and tell me the total.`
- `Sign up for the Acme newsletter with the alias yourname+acme. Ask me before you confirm.`
- `When an email arrives from *@supplier.com, summarize it and draft a reply.`
- `Create an AgentMail inbox for each client: acme and globex. List the addresses.`

## Does this work with Grok Build?

Grok Build, the terminal coding agent from xAI, can use the same AgentMail server. Put your API key in the `AGENTMAIL_API_KEY` environment variable, then run:

```sh
grok mcp add --transport http agentmail https://mcp.agentmail.to/mcp --header 'Authorization: Bearer ${AGENTMAIL_API_KEY}'
```

The single quotes keep `${AGENTMAIL_API_KEY}` as text in the command. Grok Build expands `${VAR}` in headers from your environment ([Grok Build MCP docs](https://docs.x.ai/build/features/mcp-servers)). AgentMail's guide says to use the `Authorization: Bearer` header in Grok Build, not `x-api-key`.

A docs portal with Ask AI
and support tickets

Connect a repository, or describe your product to start. Each docs site has search, Ask AI, an API console, an MCP server and support tickets.

Publishes from GitHub on every push

Works with Mintlify repositories

API console from your OpenAPI file

MCP server and llms.txt for AI agents

Ask AI and support tickets

Analytics for people and AI agents

Start Free →

Questions? Ask AI in our docs
No card required.

## Frequently Asked Questions

### Does the Bot obey instructions inside an email that it receives?

No. A Bot treats email from other people as information, not as instructions. A request inside an email never counts as your permission to send email or to do other actions ([xAI docs](https://docs.x.ai/grok-bot/computer-and-apps#give-your-bots-an-email-address)).

### What happens to the address if a team admin turns off agent email?

The Bots lose their email tools, and email routines stop. Grok Bot still receives and keeps mail to the existing addresses, and each member keeps the address ([Grok Bot help](https://cursor.com/help/grok-bot/agent-email)).

---

[View the canonical page](https://revdoku.com/blog/give-grok-bot-email-inbox/) · [Browse llms.txt](https://revdoku.com/llms.txt)