Connect OpenCode to Roam
Set up in minutes
Choose where it runs
On your computer through your own OpenCode, 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 OpenCode first calls in. opencode mcp add only saves the config. OpenCode connects when it starts — run opencode, or restart a running one.
1. Run this in your terminal
2. Choose Remote and paste your server URL
3. Choose No when asked about OAuth authentication — the link itself is the key
<your-link> is your personal server URL — setup mints it for you.
Tools OpenCode 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 OpenCode
Frequently asked questions
More ways to connect
Open your OpenCode agent in one click.
NoClick runs OpenCode for you with Roam wired in as tools. Connect your account and run.