Integration · Communication

Connect Claude & ChatGPT to Roam

Ask your AI what was decided in this morning's meeting, to post an update in a group, or to find a message someone sent last week. It can read and send chat messages, search messages and meetings, read meeting transcripts and ask questions about a meeting. It can also manage groups, calendar events and meeting links in Roam.

Connect Roam free

Free plan, no credit card. Takes about a minute.

Try asking

“What were the action items from this morning's product meeting?”
The AI finds the meeting and asks Roam for the action items, based on the meeting's transcript.
“Post in the Design group that the release moves to Thursday.”
It finds the group and sends your message there. The message is posted to the group's members.
“Find what Jonas wrote about the pricing page last week.”
It searches chat messages for the topic, filtered by sender and date, and shows the matches.

What your AI can do

Chat and messages

List chats, read messages and threads, search by sender, group or date, and send, edit, react to or delete messages.

Meetings and transcripts

List and search meetings, see who attended, read transcripts and ask questions about a meeting.

Groups, people and calendar

Find users, create groups and add members, list and create calendar events, and create meeting links.

“Create a group for the Q4 launch with Anna and Peter.”
It looks up Anna and Peter in your organization and creates the group with both as members.
“Book a 30-minute call with [email protected] tomorrow at 10.”
It creates a calendar event with Lisa as attendee. Roam may send her an invitation.
“Who attended Monday's all-hands, and what was said?”
It lists the meeting's participants and reads the transcript so it can summarize the discussion.

67 tools for Roam

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_group_membersChanges dataAdd people to a group by group `id` with a `members` list (each with userId and role).
add_reactionChanges dataAdd an emoji reaction by `name` to a message identified by `chat_id` and `timestamp`.
archive_groupVisible to othersArchive a group. Has effects visible outside this system.
ask_about_meetingChanges dataAsk a question about a meeting (e.g. summary, action items) by meeting `id` and `prompt`; the answer is based on the meeting's transcript.
attach_chatChanges dataLink a chat. API summary: Resolve a chat link.
create_a_chat_message_linkChanges dataLink a chat. API summary: Create a chat message link.
create_assetChanges dataCreate a new asset. Required: name. API summary: Create a file upload.
create_calendar_eventChanges dataCreate a calendar event with `title`, `start`, `end` (RFC3339), optional `attendees` emails, `description`, `time_zone` and recurrence `rrule`. Attendees may receive invitations.
create_chat_append_streamChanges dataCreate a new chat append stream. Required: stream id or text. API summary: Append to a streaming message.
create_chat_postChanges dataCreate a new chat. Required: chat id, user id or text. Search chats first to avoid duplicates. API summary: Post an ephemeral message.
create_chat_scheduled_cancelChanges dataCreate a new chat scheduled cancel. Required: scheduled message id. API summary: Cancel a scheduled message.
create_chat_start_streamChanges dataCreate a new chat start stream. API summary: Start a streaming message.
create_chat_stop_streamChanges dataCreate a new chat stop stream. Required: stream id. API summary: Stop a streaming message.
create_chat_typingChanges dataCreate a new chat typing. API summary: Send a typing indicator.
create_chat_unfurlChanges dataCreate a new chat unfurl. Required: chat id, message timestamp or unfurls. API summary: Unfurl a link.
create_groupChanges dataCreate a group with a `name` and `members` (each with userId and role); optionally `private`, `description` and `enforce_threads`.
create_group_joinChanges dataCreate a new group join. Required: id. API summary: Join a group.
create_group_renameChanges dataCreate a new group rename. Required: id or name. API summary: Rename a group.
create_guest_badge_createChanges dataCreate a new guest badge create. Required: email. API summary: Grant a Guest Badge.
create_guest_badge_revokeChanges dataCreate a new guest badge revoke. Required: email. API summary: Revoke a Guest Badge.
create_guest_badge_updateChanges dataCreate a new guest badge update. Required: email or visit permission. API summary: Update a Guest Badge.
create_magicast_share_linkChanges dataCreate a new magicast share link. Required: id. API summary: Get a shareable Magicast link.
create_meeting_linkChanges dataCreate a shareable meeting link with a `name`, optional `start`, `end` and `host`.
create_meeting_share_linkChanges dataCreate a new meeting share link. Required: id. API summary: Get a shareable meeting link.
create_storyChanges dataCreate a new story. Required: asset id. API summary: Post story.
create_token_revokeDeletesCreate a new token revoke. Destructive action; may require approval. API summary: Revoke access token.
create_userChanges dataCreate a new user. Required: user id, external id or display. API summary: Set a user's external activity.
create_user_activity_clearChanges dataCreate a new user activity clear. Required: user id or external id. API summary: Clear a user's external activity.
delete_groupsDeletesPermanently delete a group. Destructive action; may require approval. API summary: Remove group members.
delete_messageDeletesDelete a chat message by `chat_id` and message `timestamp`. This cannot be undone.
delete_reactionsDeletesPermanently delete a reaction. Destructive action; may require approval. API summary: Remove reaction from message.
edit_messageChanges dataEdit a message you posted, by `chat_id` and the message `timestamp`, with new `text` or `markdown`.
export_messageeventsChanges dataExport messageevents. API summary: Export message events.
get_a_meeting_linkChanges dataLink a meeting. API summary: Get a meeting link.
get_a_user_s_status_bubbleGet the current status of a user. API summary: Get a user's status bubble.
get_groupGet one group by `id` or `name`, with description and settings.
get_magicastGet one magicast. API summary: Get magicast info.
get_meetingGet one meeting by `id`, with time, room and participants.
get_meeting_transcriptGet the transcript of a meeting by meeting `id`.
get_userGet one Roam user by `id` or `email`, including name and profile details.
get_user_statusChanges dataGet the current status of a user. API summary: Set a user's Will Return / Out of Roam.
get_user_status_statusChanges dataGet the current status of a user. API summary: Clear a user's Will Return / Out of Roam.
get_user_status_user_status_bubble_clearChanges dataGet the current status of a user. API summary: Clear a user's status bubble.
list_calendar_eventsList calendar events between `start_date` and `end_date`.
list_chat_scheduled_listsList chat scheduled lists. Optional filters: chat id or before. Results are paginated. API summary: List scheduled messages.
list_chatsList the chats (DMs and group chats) you can access. Use this to find a chat ID.
list_group_membersList the members of a group by group `id`.
list_groupsList groups, optionally filtered by name with `query` or by `type`. Use this to find a group ID.
list_lobbiesList lobbies. Optional filters: handle.
list_lobby_booking_listsList lobby booking lists. Optional filters: lobby id or before. Results are paginated. API summary: List lobby bookings.
list_magicastsList magicasts. Optional filters: before or ascending. Results are paginated.
list_meeting_participantsList who attended a meeting, by meeting `id`.
list_meetingsList recent meetings held in Roam. Use this to find a meeting ID.
list_messagesList messages. Optional filters: before or ascending. Results are paginated. API summary: List conversations.
list_reactionsList reactions. Optional filters: chat id, timestamp or thread timestamp. API summary: List reactions on a message.
list_tokensList tokens. API summary: Access token info.
list_user_activity_listsList user activity lists. Optional filters: user id. API summary: List a user's external activities.
list_userauditlogsList userauditlogs. Optional filters: date. API summary: User Audit Log.
list_usersList or search people in your Roam organization with `q`, or look up specific `ids`. Use this to find a user ID.
read_chat_messagesRead messages from a chat: pass one of `chat_id`, `group_id` or `user_ids`, and optionally `thread_timestamp` to read a thread's replies.
search_guest_badge_listsSearch guest badge lists by email or host user id. Use this to find existing guest badge lists before creating a new guest badge list. Results are paginated. API summary: List Guest Badges.
search_meetingsSearch meetings by free-text `query`, optionally before a date.
search_messagesChanges dataSearch chat messages with a free-text `query`, filtered by sender (`from`), participants (`with`), groups (`in`) or date (`after`, `before`).
send_messageChanges dataSend a chat message in markdown `text` to a `chat_id`, `group_id` or a DM with `user_ids`; reply in a thread with `thread_timestamp`, or schedule with `send_at`. The message is posted to the recipients.
set_a_user_s_status_bubbleChanges dataGet the current status of a user. API summary: Set a user's status bubble.
update_a_meeting_linkChanges dataLink a meeting. API summary: Update a meeting link.
upload_productChanges dataUpload a product. API summary: Upload an item.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Roam from the app list.
2
Paste your key
Paste a Roam API key. In Roam, click the Settings gear, go to Roam Administration > Developer and click Add ApiClient. Give it a name, choose API key as Authorization type and save. Then tick the Access Scopes the AI needs, for example chat, group, meeting and user read/write, save again and copy the API key.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Roam?

The AI can list chats, read and search messages, list and search meetings, read transcripts and participants, ask questions about a meeting, and read users, groups and calendar events. It can send, edit and delete messages, add reactions, create groups and add members, and create calendar events and meeting links.

Does the AI see my Roam API key?

No. Your Roam API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reading only. Sending a message reaches other people, and deleting a message cannot be undone. These actions can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Roam account.

Which access scopes does the API key need?

The Access Scopes you tick on the API client in Roam decide what the key may do. Tick the scopes that match the tools you switch on, for example chat for messages and meeting for transcripts. If a scope is missing, Roam refuses the call.