# Hermes Agent + Pear MCP guide

Use Pear with Hermes Agent by adding Pear as a remote HTTP MCP server in `~/.hermes/config.yaml`.

## OAuth config

```yaml
mcp_servers:
  pear:
    url: "https://pearmcp.com/api/mcp"
    auth: oauth
    tools:
      prompts: false
      resources: false
```

After editing config, restart Hermes or run `/reload-mcp`.

Hermes prefixes remote MCP tools with the server name, so Pear tools appear with an `mcp_pear_` prefix.

## API key fallback

```yaml
mcp_servers:
  pear:
    url: "https://pearmcp.com/api/mcp"
    headers:
      Authorization: "Bearer YOUR_PEAR_API_KEY"
    tools:
      prompts: false
      resources: false
```

## Use cases

- Use Hermes as a morning operator that summarizes calendar, mail, and tasks.
- Ask Hermes to turn a conversation into follow-up tasks and a calendar hold.
- Let Hermes search recent provider mail before drafting a customer or vendor response.