Roam

Roam MCP integration

Posts messages and reads chat history, provisions users and groups over SCIM 2.0, and lists meetings, recordings, transcripts, and audit entries.

39actions available

Three actions you can hand over today

Every action runs live through MCP. Nothing to build, nothing to maintain.

  • Lookup user by email

    Lyro finds a user account in Roam by their email address. Agents quickly identify customers without searching manually through contact lists.

  • Post message to chat

    Lyro sends a message directly to a Roam chat. Agents reach customers in their preferred channel without leaving the support interface.

  • Upload file to roam

    Lyro uploads attachments to Roam for sharing in chat. Agents can send documents, screenshots, and files without switching tools.

See all 39 actions

How businesses use Roam + Lyro

Each card is one request a support team gets, and the Roam actions Lyro runs to close it.

  • Post into a Roam chat and keep the thread alive

    Lyro posts plain markdown or a rich Block Kit layout with headers, sections, and buttons, uploads a file first when the message needs an attachment, and reacts when an acknowledgement is all that is wanted.

    Post Message to ChatUpload File to RoamAdd Reaction to Message
  • Catch up on a chat without scrolling it

    Lyro lists the messages in a chat filtered by date range, enumerates the DMs, MultiDMs, and channels the connection can reach, and resolves a chat address to the user or visitor behind it.

    Get Chat HistoryList Roam ChatsGet Address Info
  • Provision and deprovision people over SCIM

    Lyro creates a user through SCIM 2.0, adds or removes them from a group with a partial patch, and archives the account when someone leaves - a soft delete that deprovisions rather than erases.

    Create Roam UserPatch a GroupDelete Roam User
  • Find the meeting, the recording, or the transcript

    Lyro lists meetings, recordings, and transcripts across a date range with cursor pagination, so a question about what was said in a session is answered without anyone hunting through the workspace.

    List Roam MeetingsList Roam RecordingsList Roam Transcripts

How it works

Get started in 3 steps

Connect once, then just ask. There is no workflow builder to learn and nothing to maintain — Lyro reads the Roam actions it has and picks the ones a request needs.

  1. 01

    Connect Roam

    Authorize the Roam account your team already uses — one consent screen, no API keys, no mapping tables. Lyro can only do what you granted that account, and you can disconnect it at any time.

  2. 02

    Tell your agent what you need

    Describe the job the way you would hand it to a teammate. Lyro maps it to the Roam actions that close it and chains as many as the request needs.

  3. 03

    Watch it work

    The agent runs the actions inside the conversation the customer is already in, so nobody copies data between tabs and your team can take over at any point.

    Get started free
Roam · Lyro

Everything else about Roam

Setup, permissions, and the limits of what Lyro can do inside Roam.

  • It varies by action, and Get Token Info reports what the current access token actually holds along with the bot's chat address. Get User Info requires user:read, with further scopes needed for fields such as email, and Get Meeting Link requires its own meeting scope.

Every action available in Roam

All 39 actions your agent can call on Roam, straight from the live MCP connection.

  • Add group members

    Add one or more group members and/or admins to an existing Roam group.

  • Add reaction to message

    Add an emoji reaction to a message in a chat.

  • Create group

    Create a group address that can be used for chat.

  • Create roam scim group

    Create a new group in your Roam organization using SCIM 2.0.

  • Create roam user

    Create a new user in Roam via SCIM 2.0 protocol for automated user provisioning.

  • Delete roam group

    Archive a group in Roam using SCIM 2.0 protocol.

  • Delete roam user

    Archive a user in Roam using SCIM 2.0 protocol.

  • Get address info

    Get information about a chat address, which is the name for any entity that may participate in a chat, such as a user, visitor, or bot.

  • Get chat history

    Lists messages in a chat, filtered by date range (after/before).

  • Get meeting link

    Get a meeting link.

  • Get roam scim resource types

    Returns the list of SCIM 2.0 resource types supported by Roam.

  • Get scim service provider config

    Retrieve Roam's SCIM service provider configuration.

  • Get scim schema

    Retrieves the definition of a specific SCIM 2.0 schema by its unique identifier (URN).

  • Get user by ID (scim)

    Retrieve a single user by their Roam Person ID using SCIM 2.0 protocol.

  • Test API connectivity

    Test endpoint for API connectivity.

  • Get token info

    Retrieves information about the current Roam access token.

  • Get user info

    Get detailed information about a single user in your Roam workspace.

  • List roam chats

    Lists all accessible chats, which consist of all DMs, MultiDMs, and Channels that your bot has been added to, in addition to all public channels.

  • List group members

    List members in a group in your Roam workspace.

  • List scim groups

    Returns a paginated list of groups in your Roam organization via SCIM 2.0.

  • List roam lobbies

    Lists active lobbies in your Roam account.

  • List roam meetings

    Lists all meetings in your home Roam, filtered by date range.

  • List roam recordings

    List all recordings in your home Roam.

  • List users (scim)

    List users in your Roam organization using SCIM 2.0 protocol.

  • List scim schemas

    List all SCIM 2.0 schemas supported by Roam.

  • List roam transcripts

    Lists all transcripts in your Roam workspace, filtered by date range.

  • List user audit log

    Get a list of user audit log entries for the account.

  • List users

    List all users in the Roam workspace.

  • Lookup user by email

    Look up a user in your Roam workspace by their email address.

  • Patch a group

    Partially updates a group using SCIM 2.0 protocol.

Ready to connect Roam?

Authorize the account and your agent has all 39 actions from the first conversation.

Support agent working at a laptop next to the Lyro mascot