HERMES

Give Hermes
a real inbox.

Add Mermail to Hermes with Streamable HTTP OAuth.

Start setup Read 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.

Copy the Mermail MCP URL

Use Streamable HTTP OAuth. Add no headers.

MCP endpoint

https://console.mermail.app/mcp

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

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)

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.

Claude Duet

Add Mermail as a custom connector on claude.ai. Duet uses it from your Claude account.

ChatGPT

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

Dot

Connect Mermail through ChatGPT Apps for email and payments your dot can use with your permission.

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.

Muse