Connect Hermes to Roam
Set up in minutes
Choose where it runs
On your computer through your own Hermes, or hosted in the cloud. The rest of setup adapts to your choice:
Pick what it can do in Roam
A preset of real Roam operations. Each one becomes a tool the agent can call, and it can't touch anything outside the list.
Connect Roam
One sign-in. The agent acts through your account, scoped to the operations you picked.
Add your personal MCP link
The last step mints a private MCP URL for this agent and walks you through exactly this, with your real link filled in. The page flips to Connected the moment your Hermes first calls in. Hermes connects when it next starts a session.
1. Run this in your terminal
2. Answer no when asked if the server requires authentication — the link itself is the key
<your-link> is your personal server URL — setup mints it for you.
Tools Hermes gets
Roam
20 toolsInspect the connected principal, workspace and token grant; needs no scope.
List one page of accessible chats. Requires chat:read.
Send a text message to one chat, group or set of DM recipients. Requires chat:send_message.
Replace a message's text. Requires chat:send_message and edit access.
Delete a message the connected principal can delete. Requires chat:send_message.
Read one page of messages in a chat. Requires chat:history.
Search one page of accessible messages. Requires chat:history.
Add a message reaction. Requires chat:send_message and chat membership.
Remove a message reaction. Requires chat:send_message.
List one page of workspace members. Requires user:read.
Get a principal by ID. Requires user:read.
List one page of visible groups. Requires group:read.
Read a visible group's details. Requires group:read.
Create a group with explicit initial members. Requires group:write.
Join a public group as the token owner. Requires group:write.
Search meeting transcripts and summaries using a personal token. Requires meetings:read.
List one page of meetings available to this token. Requires meetings:read.
Read a meeting, its summary and action items. Requires meetings:read.
Read the structured JSON transcript. Requires meetings:read.
Get or create a shareable meeting link. Requires meetings:read.shareLink.
About Hermes
Frequently asked questions
More ways to connect
Open your Hermes agent in one click.
NoClick runs Hermes for you with Roam wired in as tools. Connect your account and run.