Hermes Agent Archive / Skills

MCP OAuth Remote Gateway

Manual OAuth for remote MCP servers on headless gateways.

By Ben Barclay (benbarclay), Hermes Agent · Official Docs · Date unknown

Hermes' built-in MCP OAuth client runs a one-shot HTTP listener on `127.0.0.1:<port>`
inside the Hermes process and registers that loopback address as the OAuth
`redirect_uri`. That works perfectly for a local CLI on the user's own machine.
It breaks completely when Hermes runs as a remote gateway (container, VPS,
messaging bot), because the user's browser resolves `127.0.0.1` to the user's own
laptop, not the remote container — so the authorization code never reaches Hermes.

Platforms: linux, macos.

hermes skills install official/mcp/mcp-oauth-remote-gateway