# Roma > Roma is your AI task app: a place a person keeps lists, items and automations, on the web, a Mac and an iPhone. Its MCP server at https://api.roma.app/mcp gives any AI chat the same workspace over OAuth 2.1, with 31 tools. ## Learn How Roma works and how to use it, written by the team for people. The index is https://roma.app/learn; each article is also Markdown at its address with .md appended. ### Get started - [What Roma is](https://roma.app/learn/what-is-roma.md): Roma turns what you tell it into tasks, then helps do the work. - [Create your account and sign in](https://roma.app/learn/create-your-account.md): Sign in with Google or Apple and Roma builds your account in seconds. - [How to use the operator](https://roma.app/learn/how-to-use-the-operator.md): Tell the operator what you need in plain words and it acts or answers. - [What the operator can do](https://roma.app/learn/what-the-operator-can-do.md): It works on your lists, searches the web and acts in your connected apps. - [What a list is](https://roma.app/learn/what-a-list-is.md): A list holds items, and its properties decide what each item keeps. - [What a list can do](https://roma.app/learn/what-a-list-can-do.md): Layouts, sorting and filters, the operator's help, and sharing a list. - [Your Tasks list](https://roma.app/learn/your-tasks-list.md): Where a task lands when you name no other list, and what it keeps. - [Roma on your iPhone](https://roma.app/learn/roma-on-your-iphone.md): Your lists and your operator on the phone, a press of a button away. - [Where Roma runs: the browser, the Mac and the iPhone](https://roma.app/learn/where-roma-runs.md): One account and the same lists at roma.app, in the Mac app and on iPhone. - [Your first week with Roma](https://roma.app/learn/your-first-week-with-roma.md): Seven days of small steps, from the first task to your first automation. ### Tasks and lists - [Create a task](https://roma.app/learn/create-a-task.md): Type it, say it or share a photo, and Roma titles, dates and files it. - [Due dates, times and reminders](https://roma.app/learn/due-dates-times-and-reminders.md): A due date is a day unless you state a time, and a time rings a reminder. - [Task status and completing tasks](https://roma.app/learn/task-status-and-completing-tasks.md): The statuses a list has, how you shape them, and when a task is done. - [Notes and the Notes list](https://roma.app/learn/notes-and-the-notes-list.md): A note is a title and a body on your Notes list, nothing to tick or date. - [Create a list](https://roma.app/learn/create-a-list.md): Type a name into the New list row, then give it the properties it needs. - [Properties: what a list keeps about each item](https://roma.app/learn/properties.md): Every kind of property, set on the list and filled in on each item. - [List, board and table layouts](https://roma.app/learn/list-board-and-table-layouts.md): Cards, columns or a grid, three ways to see one list, saved per list. - [Move an item to another list](https://roma.app/learn/move-an-item-to-another-list.md): Move a task or an item onto any list, and know what travels with it. - [Sections, pins and favorites in the sidebar](https://roma.app/learn/sections-pins-and-favorites.md): Group lists into sections, pin one beside Tasks and keep favorites close. - [The body of a task or note](https://roma.app/learn/the-body-of-a-task-or-note.md): A body holds formatted text, checklists, mentions, pictures and files. - [Version history and undo](https://roma.app/learn/version-history-and-undo.md): Every edit to a body is kept 30 days, and ⌘Z takes back your last act. - [Deleted tasks, notes and lists](https://roma.app/learn/deleted-tasks-notes-and-lists.md): A deleted task, note, item or list stays recoverable for about 30 days. - [Search in Roma](https://roma.app/learn/search-in-roma.md): ⌘K finds anything by title at once, and the operator searches by meaning. - [New items in a list: the blue dot](https://roma.app/learn/new-items-and-the-blue-dot.md): A still blue dot marks what landed on a list while you were not looking. ### The operator - [What the operator does with what you say](https://roma.app/learn/what-the-operator-does-with-what-you-say.md): It answers a question, or it acts. A task by default, a note on request. - [Approvals: what the operator checks with you first](https://roma.app/learn/approvals.md): A card before a delete, a move, a send, or anything that leaves Roma. - [Web search and research](https://roma.app/learn/web-search-and-research.md): It searches the web for what it cannot know and shows its sources. - [The operator's browser, in beta](https://roma.app/learn/the-operators-browser.md): A real browser that looks things up, fills forms and prepares a payment. - [Memory: what Roma knows about you](https://roma.app/learn/memory.md): A profile Roma builds from your days and keeps in mind on every reply. - [Experts: Content Editor, Devil's Advocate and Wordsmith](https://roma.app/learn/experts.md): Named instructions you call into any chat for an answer in their voice. - [AI editing: how much the operator rewrites](https://roma.app/learn/ai-editing.md): Level, Voice and a clean-up switch decide how far Roma tidies your words. - [The conversation on a task or note](https://roma.app/learn/the-conversation-on-a-task-or-note.md): Every item has its own chat with the operator, kept beside the item. - [Talk to Roma with your voice](https://roma.app/learn/talk-to-roma-with-your-voice.md): Tap the mic, hold a key on the Mac, or press the Action Button and talk. ### Automations - [What an automation is](https://roma.app/learn/what-an-automation-is.md): A standing order Roma carries out on a schedule or when you ask. - [The automations Roma starts with](https://roma.app/learn/the-automations-roma-starts-with.md): The Morning briefing, Meeting prep, Mail check and the Daily check-in. - [Create your own automation](https://roma.app/learn/create-an-automation.md): Say what should happen and when, or fill in the form yourself. - [When an automation runs and where its result lands](https://roma.app/learn/when-an-automation-runs.md): The schedule kinds, what a run may do, and the message it leaves. ### Agents - [Agents: let ChatGPT, Claude and others work on your lists](https://roma.app/learn/agents-in-roma.md): Connect an AI you already use, and your lists are there in every chat. - [Connect ChatGPT and Codex to Roma](https://roma.app/learn/connect-chatgpt-to-roma.md): Add Roma to ChatGPT in Developer mode, or to Codex with two commands. - [Connect Claude and Claude Code to Roma](https://roma.app/learn/connect-claude-to-roma.md): Add Roma once from Claude's directory, or paste one address by hand. - [Connect Cursor, VS Code and Gemini CLI to Roma](https://roma.app/learn/connect-cursor-vs-code-and-gemini-cli.md): One click or one command adds Roma to the coding agent you already use. - [Connect Poke, Town, Grok and other agents to Roma](https://roma.app/learn/connect-other-agents.md): How Poke, Town, Grok, Muse, Instinct, OpenClaw, Hermes and Devin connect. - [API keys and signing in from an agent](https://roma.app/learn/api-keys.md): How an agent signs in, and the key for one that cannot open a browser. - [What an agent can and cannot do in your account](https://roma.app/learn/what-an-agent-can-do.md): An agent acts as you, on your own lists and what is shared with you. - [Triggers: wake your agent when something changes](https://roma.app/learn/triggers.md): Roma tells your agent the moment a list changes, instead of it checking. ### Connections - [Connect an app to Roma](https://roma.app/learn/connect-an-app-to-roma.md): Sign in once with Gmail, your calendar or the tools your work lives in. - [Tasks from your apps](https://roma.app/learn/tasks-from-your-apps.md): One click makes a list Roma keeps filled from Gmail, Granola or Notion. - [Gmail in Roma](https://roma.app/learn/gmail.md): Your operator reads your mail, drafts replies and sends what you approve. - [Google Calendar in Roma](https://roma.app/learn/google-calendar.md): See what is booked, find a free slot, and add an event when you ask. - [Google Drive in Roma](https://roma.app/learn/google-drive.md): The operator finds and reads your files. It never edits or deletes one. - [Linear in Roma](https://roma.app/learn/linear.md): Turn what you spotted into an issue in the right team, from any device. - [Notion in Roma](https://roma.app/learn/notion.md): Read pages into a task, and update a Notion database by asking. - [GitHub in Roma](https://roma.app/learn/github.md): Read the repositories you choose, and open a change when you ask. - [Slack in Roma](https://roma.app/learn/slack.md): Catch up on a channel, search messages, and post as yourself when you ask. - [Granola in Roma](https://roma.app/learn/granola.md): Ask what was decided in a meeting, and turn the action items into tasks. - [Reddit and X in Roma](https://roma.app/learn/reddit-and-x.md): Read a thread or a post into a note, and post on Reddit when you ask. - [Import your tasks from Todoist, Things or Apple Reminders](https://roma.app/learn/import-your-tasks.md): Bring your open tasks over once, with their lists, dates and repeats. - [Connect an MCP server of your own](https://roma.app/learn/connect-an-mcp-server.md): Add any MCP server to Roma, and the operator uses its tools for you. ### Sharing - [Sharing in Roma](https://roma.app/learn/sharing-in-roma.md): Share a task, a note or a whole list, and what the other person can do. - [Share a task or a note](https://roma.app/learn/share-a-task-or-a-note.md): Invite people or create a public link, and what they can edit. - [Share a list](https://roma.app/learn/share-a-list.md): Give one person or a few the whole list, with the role you choose. - [Roles: Can edit and Full access](https://roma.app/learn/roles-can-edit-and-full-access.md): Two levels, what each allows, and what only the owner can ever do. - [Invitations, public links and Shared with me](https://roma.app/learn/invitations-links-and-shared-with-me.md): How people get in, by email or by the public link, and where it all lands. - [Working together on a shared list](https://roma.app/learn/working-together-on-a-shared-list.md): Who added what, who a task is for, the shared conversation and the view. - [Stop sharing, or leave something shared with you](https://roma.app/learn/stop-sharing-or-leave.md): End a share you own, or leave one you joined, and what each does. - [Agents and automations on shared items](https://roma.app/learn/agents-and-automations-on-shared-items.md): Your operator, your automations and outside agents on something shared. ### The Mac app - [Install Roma on your Mac](https://roma.app/learn/install-roma-on-your-mac.md): Download the DMG, open it, sign in, and Roma keeps itself up to date. - [Quick chat and hold to talk](https://roma.app/learn/quick-chat-and-hold-to-talk.md): One key from any app, type or talk, and your words reach your operator. - [Keyboard shortcuts and the command palette](https://roma.app/learn/keyboard-shortcuts.md): Every chord on the Mac and in the browser, and ⌘K for everything else. - [Tabs](https://roma.app/learn/tabs.md): Every tab is its own place, with its own history, pins and shortcuts. ### The iPhone app - [Install Roma on your iPhone](https://roma.app/learn/install-roma-on-your-iphone.md): Get it from the App Store, sign in, and your lists are on your phone. - [The Action Button: talk to Roma without opening it](https://roma.app/learn/the-action-button.md): Assign Talk to Roma and a press lands your words with your operator. - [Widgets, the Lock Screen and Controls](https://roma.app/learn/widgets-lock-screen-and-controls.md): Your tasks on the Home Screen and Lock Screen, and two buttons for Roma. - [Share to Roma from any app](https://roma.app/learn/share-to-roma-from-any-app.md): Share a page, a post, text or photos, and say what Roma should do with it. - [Voice and dictation on the iPhone](https://roma.app/learn/voice-and-dictation-on-the-iphone.md): Tap the mic, talk as long as you like, and pick when the words appear. - [The Tasks tab and your lists on the iPhone](https://roma.app/learn/the-tasks-tab.md): Your Tasks list on the phone, its view menu, the plus and your lists. - [Settings on the iPhone](https://roma.app/learn/settings-on-the-iphone.md): Every card on the Settings screen and what each page holds. ### Notifications and updates - [Updates: what the bell shows](https://roma.app/learn/updates-the-bell.md): What people did on things you share, and what Roma prepared for you. - [Notification settings: how often, reminder time and the badge](https://roma.app/learn/notification-settings.md): Every switch on the page, what it changes and what it leaves alone. - [How a reminder reaches you](https://roma.app/learn/how-reminders-reach-you.md): A push on your iPhone, a banner on your Mac, and a row in Updates. ### Account, settings and privacy - [Settings in Roma](https://roma.app/learn/settings-in-roma.md): What each Settings page holds, on every device Roma runs on. - [Permissions: what the operator may do on its own](https://roma.app/learn/permissions.md): Which actions run on their own, which ask first, and which are off. - [The Event Log and reverting a change](https://roma.app/learn/the-event-log.md): A record of everything that happened to your tasks, notes and lists. - [Your data and privacy](https://roma.app/learn/your-data-and-privacy.md): What Roma keeps, who can see it, and how to see, correct or delete it. - [Delete your account](https://roma.app/learn/delete-your-account.md): Where the button is, what goes with the account, and what happens next. - [Get help and send feedback](https://roma.app/learn/get-help-and-send-feedback.md): Where to write, how to send feedback from the app, and how to rate Roma. ## Developer docs - [Overview](https://roma.app/developers.md): Every AI tool you use, one to-do list. Connect ChatGPT, Claude, Codex, Muse or any other agent to Roma through its MCP server: one address, OAuth 2.1, 31 tools over lists, items, memory and automations. - [Connect a client](https://roma.app/developers/connect.md): The two-minute setup for ChatGPT, Claude, Claude Code, Cursor, Codex, VS Code, Gemini CLI, Poke, Town, Grok, Grok Bot, Muse, Instinct, OpenClaw, Hermes Agent, Devin Desktop (Windsurf) and more. - [Authentication](https://roma.app/developers/authentication.md): OAuth 2.1 with PKCE and dynamic client registration: the discovery chain, tokens, rate limits and what to do when sign-in fails. - [Concepts](https://roma.app/developers/concepts.md): Lists, items, properties, automations, memory and the trash, as an agent meets them. - [Tools](https://roma.app/developers/tools.md): Every tool on the Roma MCP server with its parameters, result and an example call, generated from the live registration. - [REST API](https://roma.app/developers/api.md): Plain HTTP over the same operations as the MCP server, for Zapier, Make, n8n and scripts: lists, items, search, chats, trash and automations, with an OpenAPI document. - [Guides](https://roma.app/developers/guides.md): Making Roma the to-do list your assistant reaches for, saving research, filling a list, working from a task, reading an automation's run. - [Recipes](https://roma.app/developers/recipes.md): Standing orders to paste into Claude Cowork, a Claude Code Routine, ChatGPT or Codex, so the agent you already run sweeps your sources into Roma and works what is waiting there. - [Events](https://roma.app/developers/events.md): Triggers: how Roma wakes your agent when something on your lists changes. A signed webhook for anything with an address, a long poll for anything without one, MCP Events for a client that subscribes itself. - [Changelog](https://roma.app/developers/changelog.md): What changed on the Roma MCP server, newest first. ## Brand - [Brand guidelines](https://roma.app/brand.md): The Roma logo and symbol, the colors and the typefaces, with every file to download. ## Optional - [Everything in one file](https://roma.app/llms-full.txt): every developer-docs page concatenated, the brand guidelines, then every Learn article. - [Privacy policy](https://roma.app/privacy) - [Terms of service](https://roma.app/terms)