Connect your agent

Connect Clam to Hermes

One terminal command adds your Shell to Hermes. Sign in to Clam, click Allow, and Hermes can use your Gmail only as far as the Shell's rules allow. No Shell yet? Start with the Quickstart.

Hermes talks to Clam over MCP, the standard way an AI agent plugs in an outside tool. Each Shell is its own MCP server, so a second Shell installs beside the first.

Connect Hermes

Two ways in. Start with the first; the other is for when it doesn't fit.

Recommended

The simplest path: one command, and Hermes opens your browser to sign in. Pick this unless your machine has no browser.

Paste this in your terminal

On the Shell's Install tab, pick Hermes and copy the command under Sign in from the terminal. It has your server name and address filled in. Then press Enter.
Terminal
```
hermes mcp add <server name> --url <your Shell's address> --auth oauth
```
Sign in to Clam and Allow

Your browser opens on Clam, asking to connect your Shell to Hermes. Its window is titled "Let Hermes use a Shell". Sign in if you need to, then click Allow.
Press Enter to turn on Clam's tools

Back in the terminal, Hermes lists Clam's tools and asks to enable them all. Press Enter. In a Hermes chat that's already open, run /reload-mcp too.

Then click Check connection on the Install tab.

For a machine with no browser, like a server you reach over SSH. The key works only for Hermes.

Add this block to ~/.hermes/config.yaml

Under mcp_servers. Create it if it isn't there. The Install tab shows the block with your key filled in.
YAML
```
mcp_servers:
  <server name>:
    url: "<your Shell's address>"
    headers:
      Authorization: "Bearer <your key>"
```
Run /reload-mcp in Hermes

Run /reload-mcp. No restart needed. Clam's tools appear right away.

Then click Check connection on the Install tab.

Try it

With the starter policy from the Quickstart, ask Hermes:

See What your agent can do.

Run hermes mcp remove <server name>, or delete Clam's entry from ~/.hermes/config.yaml and run /reload-mcp. That only tidies Hermes. Clam's removal is the one that counts: on the Install tab, under Connected agents, click Remove access for Hermes. A sign-in stops at its next request; a key at once. Other agents keep working.

Pausing or deleting the Shell, and stopping Clam's own Gmail access, are in Remove access.

Connect Hermes

Try it

Remove access

If it doesn't work