Build. Win. $500

Join
Get started

HERMES

Give Hermes
a real inbox.

Add Mermail to Hermes with Streamable HTTP OAuth.

Start setupRead MCP docs

Why Hermes

Built for the agent you already use.

Mermail gives Hermes a dedicated inbox and payment layer so verification, checkout, and receipts stay in the same loop.

Hosted Streamable HTTP
OAuth with no API-key header
Fresh-terminal login
Headless paste-back flow

Before you start

Check 3 things.

Hermes includes MCP support.

Use one mcp_servers key in config.yaml.

Run OAuth from a fresh terminal.

Hermes MCP docs

Success contract

Done when all 3 pass.

mcp login mermail completes.

hermes chat loads Mermail without errors.

mcp_mermail_list_mailboxes succeeds.

Three steps to connect.

1

Copy the Mermail MCP URL

Use Streamable HTTP OAuth. Add no headers.

MCP endpoint
https://console.mermail.app/mcp
2

Add Mermail to ~/.hermes/config.yaml

Merge under one mcp_servers key, then log in from a fresh terminal.

Config
mcp_servers:
  mermail:
    url: "https://console.mermail.app/mcp"
    auth: oauth

# Then, from a fresh terminal:
hermes mcp login mermail
3

Authorize, then use a tool

Start or reload Hermes, then run the check. Headless: paste back the final redirect URL.

Verify
hermes chat
# or, in an existing session: /reload-mcp
Ask: "List my Mermail mailboxes" (tool: list_mailboxes)

A FEW GOOD QUESTIONS

Questions,
answered.

Fast fixes for auth, setup, and discovery.

Do I need an API key in Hermes?

No. Use auth: oauth. API keys cannot unlock PayBox or x402.

Hermes reports a YAML or MCP load error.

Keep one mcp_servers key, use spaces, then log in from a fresh terminal and reload MCP.

See all integrations

Integration index
Claude Code

Connect OAuth and install 15 skills for inbox, verification, and x402 workflows.

ChatGPT

Add Mermail as a custom OAuth app in an eligible ChatGPT workspace.

Codex

Connect OAuth and install 15 skills for inbox and x402 workflows.

Cursor

Add the hosted MCP server with OAuth—no API key required.

Grok

Connect Mermail to Grok web chat and Grok Bot with OAuth, PayBox, and inline MCP Apps.

OpenClaw

Connect with OAuth, then verify Mermail with a live probe.