# OpenMail MCP

Gmail for agents. Hosted at `https://mcp.openmail.sh/mcp`.

## Claude / OAuth

Paste this URL. Sign in, grant **read** (always) and optionally **send**.

```
https://mcp.openmail.sh/mcp
```

## Cursor / API key

```json
{
  "mcpServers": {
    "openmail": {
      "url": "https://mcp.openmail.sh/mcp",
      "headers": { "Authorization": "Bearer om_YOUR_KEY" }
    }
  }
}
```

Prefer an **inbox-scoped** key so the agent cannot see other inboxes.

## Read-only / one inbox

- `https://mcp.openmail.sh/mcp/readonly`
- `https://mcp.openmail.sh/mcp?readonly=true`
- `https://mcp.openmail.sh/mcp/inbox/INBOX_ID`
- `?toolsets=mailbox,docs`

## Old stdio-only clients

Hosted HTTP is the product. Bridge with:

```json
{
  "mcpServers": {
    "openmail": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.openmail.sh/mcp"]
    }
  }
}
```

## Example prompts

- Set up an inbox for this agent and show me the address.
- Reply to unread mail from humans.
- Add and verify mail.example.com.