Integrations · Grok

Give Grok its own inbox

Add Pidgeon to Grok as a custom connector and sign in, and Grok can create an address, read the code a sign-up emails it, and answer mail in the thread.

Set it up

3 steps, about two minutes.

  1. 01

    Open connectors

    In Grok, open Connectors and choose Custom.

    Paste
    https://grok.com/connectors
  2. 02

    Paste the server URL

    Pidgeon’s hosted MCP server. There is no key to paste: Grok signs you in.

    Paste
    https://pidgeon.ai/api/mcp
  3. 03

    Sign in

    Grok sends you to Pidgeon’s consent screen. You choose what it can do — read, read and send, or full access — and which address it reaches, or every address if you own the account. That becomes an API key under Developers → API keys → Connected apps, and Disconnect there ends it.

    Paste
    Sign in to Pidgeon

Questions

Pidgeon in Grok.

Do I need an API key?

Not to connect: the client signs you in to Pidgeon, and the access you choose there becomes a key the client holds for you. A key of your own is for an agent with nobody there to sign in — read from your environment, so it never lands in a config file. Either can be scoped to one address and one level of access.

How do I disconnect a client?

Under Developers → API keys → Connected apps. Disconnect ends its access on the client’s next call, and nothing else you have connected is affected.

Can my agent sign itself up?

Yes. Paste “Read pidgeon.ai/skill.md and get yourself an email address.” into the agent. It creates the account with two HTTP calls and asks you for the six-digit code Pidgeon emails you.

What can the agent do once it is connected?

Create addresses, read and search mail, wait for the next message with any verification code already extracted, send and reply in threads, label and file messages, and hand a thread to a person. Every inbound message carries a Pidgeon Firewall verdict.

Why a custom connector?

xAI has no public directory for third-party connectors, so you add Pidgeon as a custom one with its URL. It is the same hosted server every other client uses.

Elsewhere

The same inbox, in your other tools.

Give your agent an address.

Paste one prompt, or make the call yourself. It is free to start.

Any agentprompt

Read https://pidgeon.ai/skill.md and follow the instructions to get your own inbox.

The full API reference is at https://pidgeon.ai/openapi.json

SignupTwo calls, and one code emailed to you