Guide

Use Roma in ChatGPT, Claude and Cursor

Most AI chats forget everything when the conversation ends. Connect Roma and the chat you already use gets a place to keep your tasks, notes, lists and memory, and pick them up in any conversation.

Roma connects through the Model Context Protocol (MCP). You need a Roma account; you sign in and approve the connection in your browser the first time.

Connect

The address is the same everywhere: https://api.roma.app/mcp

Claude (claude.ai, Claude Desktop, Claude on your phone)

  1. Open Settings → Connectors → Add custom connector.
  2. Name it Roma, paste https://api.roma.app/mcp, and add it.
  3. Click Connect, sign in to Roma, and approve.

ChatGPT

  1. Open Settings → Apps & Connectors → Advanced settings, and turn on Developer mode.
  2. Back in Apps & Connectors, choose Create, name it Roma, paste https://api.roma.app/mcp, and choose OAuth.
  3. Sign in to Roma and approve. Then start a new chat.

Which ChatGPT plans can use a custom connector, and whether it can make changes or only read, depends on your plan and your workspace settings.

Claude Code

claude mcp add --transport http roma https://api.roma.app/mcp

Then run /mcp in Claude Code and sign in.

Cursor

Add this to your MCP settings (mcp.json), then sign in when Cursor asks:

{
  "mcpServers": {
    "roma": { "url": "https://api.roma.app/mcp" }
  }
}

Get the most out of it

Add one line to your chat's custom instructions (or a Claude project's instructions), so every conversation starts from where you are:

At the start of a conversation about my work, plans or anything I keep, use Roma's get_context to see my tasks, notes and what I asked it to remember. Save tasks and notes to Roma when I ask.

Then try:

  • “What's on my plate today?”
  • “Save the plan we just made as a note in my Trip project.”
  • “Add these five books to my reading list.”
  • “What did my morning briefing find today?”

What it can do

  • Give your chat an overview of your workspace: today, what's due, recent notes.
  • Search, read, create and update your tasks, notes, projects and lists.
  • Read what you asked Roma to remember about you (not change it).
  • List your automations, read what their runs found, and run one when you ask.
  • Delete things, into the trash, and bring them back.

It cannot change Roma's memory, create or edit automations, or reach your email and other apps connected to Roma. Those stay in Roma itself.

Safety

  • The connection acts only as you, only on your own workspace.
  • Your chat app asks before changing anything. Reads can run without asking if you allow that.
  • Every delete is recoverable for 30 days.
  • Running an automation can act in apps connected to Roma, so your chat app always asks first.

To disconnect, remove Roma in your chat app's settings. To have us revoke the connection on our side too, email hello [at] roma.app. See our privacy policy for how connected apps handle your data.