Connect an app to Roma
Sign in once with Gmail, your calendar or the tools your work lives in.
A connection is Roma's link to an app you already use: Gmail, Google Calendar, Google Drive, Linear, Notion, GitHub, Slack, Granola, Reddit and X. You sign in with the app once, under Settings → Connections, and from then on your operator reads what you allowed and acts in the app when you ask, on every device you use Roma on.
What a connection lets the operator do
Mara asks "What came in this morning that needs a reply?" With Gmail connected, the operator reads the threads and answers with the three that need her, each with its link. Noor says "Create a dentist appointment on Thursday at 3" and, with Google Calendar connected, the event lands on her calendar. Sam asks for the headcount figure in the Q3 plan, and with Google Drive connected the operator reads the document and quotes it.
Each app brings its own set of actions, and each has its own article: Gmail, Google Calendar, Google Drive, Linear, Notion, GitHub, Slack, Granola and Reddit and X. Todoist connects for one purpose, bringing your tasks over. The public overview of every connection is at /connections.
Reading is where most of the value is: the thread behind a reply, the file behind a task, the slot that is still free. Anything that leaves your account, a sent email, a Slack message, a comment on an issue, asks you first.
How to connect an app
Open Settings → Connections. Every app Roma can connect to is a row with the app's mark.
Press the app's name. A browser window opens on that app's own sign-in page.
Sign in and allow what the page lists. The page then says Connected, and you can close it.
Back in Roma, the row shows a green check within a few seconds. Press the row to open the connection's page.
The operator can start the same sign-in from a conversation. When you ask for something that needs an app you have not connected, it offers the connection as a card, and pressing the card opens the same sign-in page.
On your iPhone, Settings → Connections has the same rows. The sign-in opens in a sheet, and you tap Done when the page says Connected. A connection holds one account: the Gmail you connect is the Gmail Roma reads.
The sign-in page may say it is powered by Composio. That is the service that keeps the sign-in with each app on Roma's behalf, so the access an app grants is held there, never by Roma itself.
What you allow, and what asks first
The connection's page lists what the operator may do in that app, grouped by the kind of act:
Reading: finding and reading. Always allowed. Looking is not doing.
Creating: drafting and creating. Nothing leaves your account.
Updating: updating something that already exists.
Deleting: removing things. Recoverable where the app allows it.
Sending: sending to other people, under your name. There is no undo.
For every group but Reading you choose Always allow, Ask first or Never. Ask first shows you a card with the exact action and waits for your approval. Never removes those actions from the operator's toolbox, so it cannot raise them at all. Sending and Deleting ask first unless you say otherwise. The list covers the actions Roma offers for that app, and anything not listed it cannot do at all. The card itself is explained in Approvals.
A few connections keep a setting of their own on the same page: the calendars Roma reads, the repositories it may touch, the team new Linear issues go to, the Notion databases it pinned. Those settings are on the Mac and in the browser.
When a connection stops working
A changed password or a revoked grant leaves the row reading Not working, with Reconnect beside it. Reconnect runs the same sign-in and replaces the old connection. Nothing else is touched.
How to disconnect
Open Settings → Connections, press the app, then Disconnect. Roma loses its access on the spot, and the settings it kept for that app are removed with it. Your tasks and notes stay as they are. X is the one exception: it is included with Roma and has no account to disconnect, so its page says Disable instead.
Questions people ask
Does Roma send anything without asking?
No. Sending is its own group on every connection, and it asks first unless you set it to Always allow yourself. The card shows what is about to go out, the recipient and the body of an email, the channel and the text of a Slack message, before anything leaves.
Can I connect two Gmail accounts?
A connection holds one account. Connect the account Roma should read. To switch, disconnect it and connect the other.
Where do I see what a connection did?
In the conversation where it happened. Every action shows as a line carrying the app's mark, and an action that asked first shows the card you answered, so the record of what ran stays in the chat.
Does connecting an app change what the operator does on its own?
Two connections switch something on. Gmail turns on Mail check, a morning automation that goes through your new mail, and Google Calendar turns on Meeting prep, which prepares the day's meetings. Both are described in the automations Roma starts with. Every other connection waits for you to ask.