Connect Hermes Agent to Pear MCP

1. Create your Pear account

Sign up at pearmcp.com, then connect Apple iCloud or Microsoft 365. Hermes can use Pear OAuth for the cleanest setup, or a Pear API key if you prefer a static header in config.

2. Add Pear to Hermes MCP config

Hermes reads MCP servers from ~/.hermes/config.yaml. For Pear OAuth, add this server entry:

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

On first connect, Hermes opens a browser authorization flow and stores tokens under its MCP token directory. The prompts andresources settings keep Hermes focused on Pear's callable tools. On remote or headless machines, use Hermes' paste-back OAuth flow from an interactive terminal so the browser callback can be copied into the running session.

API key fallback

If your Hermes build cannot complete OAuth, use a Bearer header with your Pear API key. Keep the config file private because this stores the token directly.

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

3. Reload and test Pear

Restart Hermes or run /reload-mcp after changing the config. Hermes prefixes remote MCP tools with the server name, so Pear tools appear with a mcp_pear_ prefix.

• What is on my calendar today?
• Create reminders from these meeting notes.
• Find a free time for a follow-up call next week.
• Search recent mail from this customer and summarize the thread.

What Pear unlocks inside Hermes

• Give Hermes live Calendar, Tasks/Reminders, Contacts, and Mail tools through remote MCP.
• Use Apple iCloud and Microsoft 365 provider workflows from the same Pear endpoint.
• Filter prompts/resources while keeping Pear's action tools available.
• Reload MCP config without rebuilding a local tool server.

Hermes workflows worth testing

• Use Hermes as a morning operator: summarize calendar, mail, and tasks into one briefing.
• 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.