Skip to content

MCP serverGrok Bot

Connect Grok Bot to your Shipmail email

Grok Bot is xAI's always-on agent for SuperGrok subscribers. It runs on its own cloud computer and keeps working while you are away. Connect Shipmail and it can work on the email at your own domain.

Last updated

Connect Shipmail

  1. Add a custom connector on grok.com

    Open Connectors, choose New Connector, then Custom, and enter https://shipmail.to/api/mcp.

  2. Sign in on Shipmail

    Grok sends you to the Shipmail sign-in page. Pick what the connection may do: Read and draft, Mail assistant, Full access, or Custom.

  3. Hand Grok Bot a job

    Grok Bot uses the same connector. Try: "Go through hello@yourdomain.com, answer the easy ones as drafts, and list what needs me."

What Grok Bot can do with your Shipmail

  • Read, search and answer email, in the thread it belongs to.
  • Write drafts, send now, or schedule a send for later.
  • Create calendar events, check your availability and set up booking pages.
  • Write a newsletter, send you a test, schedule it, and manage subscribers.
  • Create mailboxes, folders and inbox rules, and set an auto-reply.

Each of these is a Shipmail tool. The full list is on tools, resources and prompts.

Limit what Grok Bot can do

  • Pick Read and draft when you sign in. Grok Bot can read and write drafts, and you press send.
  • Sign in with a mailbox address and its password instead of your account. The connection then only reaches that one mailbox.
  • Revoke the connection any time under Developer, then Connections.

More detail on MCP permissions and security.

Give Grok Bot its own mailbox

Create a mailbox like agent@yourdomain.com and use that mailbox's address and password on the Shipmail sign-in page. Grok Bot then sends from its own address, so people can tell its mail from yours. Your personal inbox stays out of reach. Read why your agent should have its own address.

Grok Bot can also claim its own inbox, with an address ending in @mail.grokbot.com. That works for sign-ups and verification codes. For mail that customers or partners see, use a mailbox on your own domain. Read how the two compare.

Start Grok when new mail arrives

  1. Create a Grok automation with a webhook trigger

    On grok.com, open Automations and add a Webhook trigger. Keep the Shipmail connector on and say what to do with a new email. The event only carries the sender, subject and message ID, so tell it to open the email with the Shipmail connector. Save, then copy the endpoint and the signing secret. Grok shows the secret only once.

  2. Create a Shipmail webhook

    Under Developer, then Webhooks, enter the automation's endpoint. Pick the message.received event and Grok Bot's mailbox. Paste Grok's secret, which starts with whsec_, into Standard Webhooks signing secret.

  3. Test it

    Use Send test event, then email the mailbox. Grok queues a run when the event arrives, and the run shows under Executions, usually within a few minutes. More on webhooks.

Frequently asked questions

Do Grok and Grok Bot need separate connections?

No. Grok Bot uses the connectors on your Grok account. Connect Shipmail once on grok.com and both can use it.

Should Grok Bot log in to my webmail instead?

We would not. A browser login hands it your password and everything in the inbox. The connector gives it only the permissions you pick, and you can revoke it without changing a password.

Can Grok Bot send email without asking me?

Only if you allow it. Pick Read and draft when you sign in and Grok Bot can only leave drafts in your Drafts folder. You send them yourself.

Can Grok Bot's built-in inbox use my domain?

xAI has not announced own-domain support for it. To use your domain today, connect a Shipmail mailbox on your domain and Grok Bot sends from that address.

How do I disconnect Grok Bot?

In Shipmail, open Developer, then Connections, and revoke the Grok connection. Grok and Grok Bot lose access at the same time.