Skip to content
Connect Help Center
Return to ConnectContact support

Connect Hermes Agent

Hermes Agent connects to remote services from its configuration file. This setup is intended for a technical administrator or someone comfortable editing a YAML file and running a command in a terminal.

Get the MCP URL

Section titled “Get the MCP URL”
  1. Sign in to Connect and open the workspace Hermes should use.
  2. Open Authorized apps, select Add an AI app, and choose Hermes Agent.
  3. Copy the MCP URL shown in the dialog.

Add Connect to Hermes

Section titled “Add Connect to Hermes”

Open ~/.hermes/config.yaml and add a server under mcp_servers. Replace the placeholder with the MCP URL from Connect:

mcp_servers:
  connect:
    url: "PASTE_THE_MCP_URL_HERE"
    auth: oauth

Save the file, then run this command from a fresh terminal:

Terminal window
hermes mcp login connect

Complete the browser sign-in and choose the Connect workspace. Hermes saves the authorization for later runs. If Hermes is running on another machine, use its paste-back or SSH forwarding option to complete the browser step on that machine.

Check the connection

Section titled “Check the connection”

Start Hermes and ask about the companies in the workspace you selected. Keep the server’s tool list as small as the intended accounting workflow allows. If Hermes asks you to authenticate again, run hermes mcp login connect and complete the browser sign-in.

For current configuration and sign-in behavior, see Hermes Agent’s MCP guide.

Next steps

Section titled “Next steps”