How to Connect Hermes Agent to iCloud and Microsoft 365

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.yamlunder mcp_servers. Its official MCP docs show local stdio servers and remote HTTP servers in the same config. For Pear OAuth, add this remote server entry:

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

Hermes documents remote OAuth as auth: oauth; the MCP client opens a browser on first connection. Theprompts andresources settings keep Hermes focused on Pear's callable tools instead of optional prompt/resource wrappers.

API key fallback

If your Hermes build cannot complete OAuth, use a Bearer header with your Pear API key. Hermes resolves ${VAR} placeholders in remote URLs and headers from the environment, including values placed in~/.hermes/.env.

mcp_servers:
  pear:
    url: "https://pearmcp.com/api/mcp"
    headers:
      Authorization: "Bearer ${PEAR_API_KEY}"
    tools:
      prompts: false
      resources: false

3. Reload and test Pear

After adding the config, run hermes mcp login pearfrom a fresh terminal if OAuth needs a browser flow. Hermes notes that editing config inside a running session can trigger a shorter auto-reload timeout, whilehermes mcp login pear waits for interactive auth. After later config edits, restart Hermes or run/reload-mcp. Hermes prefixes tools with the server name, so Pear tools appear as mcp_pear_....

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.

Connect Hermes Agent to Pear MCP