Repository avatar
AI Tools
v0.1.0
active

openmail

sh.openmail/openmail

Gmail for agents: create inboxes, read and reply to mail, send email, manage domains. OAuth sign-in.

Documentation

OpenMail MCP

Hosted Streamable HTTP MCP at https://mcp.openmail.sh/mcp. Email inbox for AI agents: one inbox, read mail that wants a reply, reply in-thread.

Attachments: get_attachment returns the file (images as image content, other files as an embedded resource, 4 MB inline limit). get_attachment_text returns extracted text only.

There is no local stdio catalog — stdio-only clients should use mcp-remote.

Connect

Claude (OAuth): paste https://mcp.openmail.sh/mcp

Cursor (OAuth): Add to Cursor, or add the URL below without headers. Also on cursor.directory as a plugin (.cursor-plugin/plugin.json + mcp.json).

Claude Code: claude mcp add --transport http openmail https://mcp.openmail.sh/mcp, or install as a plugin (claude plugin marketplace add openmailsh/mcp, then claude plugin install openmail@openmailsh-mcp): the plugin bundles the server with the openmail skill, which teaches the agent when to reach for email and how to handle a thread. The plugin lives in plugin/ and holds only Markdown, JSON and the logo: the Claude directory refuses code files from unverified organisations, so keep code out of it.

VS Code / any registry client: listed in the MCP Registry as sh.openmail/openmail.

Cursor or headless agents (API key):

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

Prefer an inbox-scoped key. Read-only: /mcp/readonly. One inbox: /mcp/inbox/{id}.

Keys and transcripts: over OAuth (Claude, Cursor sign-in) setup_agent_email and mint_inbox_key never return a token — the session is already authenticated, and anything returned lands in the chat. They point to the console, which shows a new key once in the browser. Over an API key (headless agent) the token is returned in the tool result; move it to the agent's env.

stdio-only clients: npx -y mcp-remote https://mcp.openmail.sh/mcp

Env

NamePurpose
OPENMAIL_API_URLAPI origin (https://api.openmail.sh)
MCP_RESOURCE_URLOAuth resource (https://mcp.openmail.sh)
MCP_JWT_SECRETSame secret as the API. Required in production; outside production falls back to NEXTAUTH_SECRET
CONSOLE_ORIGINConsent page host
PORTListen port
POSTHOG_API_KEYTurns on PostHog MCP Analytics ($mcp_tool_call per call). Unset = off
MCP_ANALYTICS_DEBUGSet to log every captured analytics event

See .env.example.

Local

pnpm install
pnpm test
pnpm dev

Contributing

Open an issue or PR. Run pnpm typecheck && pnpm test before pushing.

MIT © OpenMail

No installation packages available.

Remote