Connect Roam HQ to Your AI Agent

Use AI with Roam HQ to send bot messages to a group and inspect meeting recordings or magicast records.

5 tools API key

Try a Roam HQ Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Roam HQ

Send a Group Update

Find available public groups and send a supplied bot message.

/oo Roam HQ: List groups, then send group [ID] this message: [text].

Review Meeting Records

List dated recordings and inspect a selected magicast record.

/oo Roam HQ: List recordings from [start] to [end], list magicasts and get magicast [ID].

Start Working with Roam HQ

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Roam HQ

    Provide a Roam HQ API key from Administration > Developer.

    Connect Roam HQ →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Access to the target Roam HQ organization and group.
  • Group lists include public non-archived groups. Sending uses a single group ID; meeting-record lists do not imply transcript text is available.

Roam HQ Tools

Use AI with Roam HQ to send bot messages to a group and inspect meeting recordings or magicast records.

Send a Group Update

Find available public groups and send a supplied bot message.

Review Meeting Records

List dated recordings and inspect a selected magicast record.

5 tools

List Groups

List public, non-archived groups in the authenticated Roam HQ organization.

roam.list_groups

Send Message

Send a message to a single Roam HQ group as a bot.

roam.send_message

List Recordings

List Roam HQ meeting recordings with optional date filtering and pagination.

roam.list_recordings

List Magicasts

List Roam HQ magicasts in reverse chronological order.

roam.list_magicasts

Get Magicast

Retrieve a Roam HQ magicast by ID.

roam.get_magicast

Frequently Asked Questions

Can I message every group at once?

send_message targets one group ID per call.

Does the group list include archived groups?

It lists public, non-archived groups in the organization.

What should I specify in my request?

Group lists include public non-archived groups. Sending uses a single group ID; meeting-record lists do not imply transcript text is available.

Connect Roam HQ

About Roam HQ ↗