MCP server for Claude, ChatGPT, and Cursor

Omamo has an MCP server. Connect it to Claude, ChatGPT, Codex, Cursor, VS Code, or Antigravity, and the app can find, read, and save your links and notes.

Server address

https://omamo.app/mcp

The server uses Streamable HTTP. You sign in with your Omamo account, so there is no key to copy. MCP (Model Context Protocol) is the standard way for AI apps to use other services.

How connecting works

1. Add the server address in your AI app. The steps for each app are below.
2. The app opens Omamo in your browser. Sign in with Google if you are not signed in.
3. Omamo shows the app’s name and what it asks for. Choose whether it may make changes, then press Allow.
4. The browser goes back to the app, and the app can use Omamo.

To disconnect an app, open Settings and press Disconnect under Connected apps. The app loses access at once.

Set up your app

Claude (claude.ai and Claude Desktop)

1. Open Settings, then Connectors, and choose Add custom connector.
2. Type Omamo as the name and https://omamo.app/mcp as the URL.
3. Choose Connect, then sign in and press Allow.

On a Team or Enterprise plan, an owner adds the connector first. You can set the read-only tools to always allowed.

Claude Code

claude mcp add --transport http omamo https://omamo.app/mcp

In Claude Code, type /mcp, choose omamo, and choose Authenticate.

ChatGPT

In Settings, under Apps, add a custom app (an MCP server) with the address https://omamo.app/mcp and OAuth sign-in. Depending on your plan, ChatGPT asks you to turn on developer mode first.

Codex

codex mcp add omamo --url https://omamo.app/mcp
codex mcp login omamo

Or add the server to ~/.codex/config.toml, then run the login command:

[mcp_servers.omamo]
url = "https://omamo.app/mcp"

Cursor

Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:

{
  "mcpServers": {
    "omamo": {
      "url": "https://omamo.app/mcp"
    }
  }
}

In Cursor’s MCP settings, choose Connect next to omamo.

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "omamo": {
      "type": "http",
      "url": "https://omamo.app/mcp"
    }
  }
}

Choose Start above the server, then sign in when VS Code asks.

Antigravity

Open the MCP servers panel, choose the raw config, and add this to mcp_config.json:

{
  "mcpServers": {
    "omamo": {
      "serverUrl": "https://omamo.app/mcp"
    }
  }
}

Other apps

Any app that supports remote MCP servers with OAuth can connect with the address. If your app only runs local servers, use mcp-remote, which needs Node.js:

{
  "mcpServers": {
    "omamo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://omamo.app/mcp"]
    }
  }
}

What the app can do

Tool	What it does	Changes things
list_spaces	The spaces you belong to.	No
list_boards	The boards in a space.	No
list_collections	The collections on a board.	No
list_items	The links and notes in a collection, a page at a time.	No
get_item	One link or note, with a note’s whole text, and on Pro a link’s saved article.	No
search	Find boards, collections, links, and notes by their words.	No
list_tags	The tags in a space.	No
list_tagged_items	The links and notes with a tag.	No
list_starred	Your starred collections and pinned items.	No
save_link	Save a web address into a collection.	Yes
create_note	Write a note into a collection.	Yes
update_item	Change a link’s or note’s title, address, text, or tags.	Yes
move_item	Move a link or note to another collection.	Yes
delete_item	Move a link or note to the trash, restorable for 30 days.	Yes
move_items	Move up to 100 items to one collection.	Yes
tag_items	Add or take off tags on up to 100 items.	Yes
delete_items	Move up to 100 items to the trash.	Yes
create_board	Add a board to a space.	Yes
update_board	Rename a board or change its description.	Yes
create_collection	Add a collection to a board.	Yes
update_collection	Rename a collection or change its description.	Yes

If you do not let the app make changes, it gets only the first nine tools. The app can never delete spaces, boards, or collections, invite people, empty your trash, or see your plan or account.

Limits

• An app can make 120 tool calls a minute for you, inside Omamo’s usual limits.
• Your plan’s limits apply, as in the app. On Free, you hold 200 saves across the spaces you own.
• The app signs in again by itself every 15 minutes, for up to 30 days.

Safety

• The app acts as you. It sees what you see in Omamo, including spaces other people share with you.
• Saved pages and notes can contain text written to trick an AI. Omamo returns them as data, but keep your app’s confirmation on for tools that change things.
• Connect only apps you trust. Omamo shows where each app sends you back, before you allow it.
• Deleted links and notes stay in the trash for 30 days, so you can restore them.

Troubleshooting

The app says Omamo is not connected

Connect it again. This happens after you disconnect the app, or after 30 days without use.

Sign-in starts over each time

Clear the app’s saved sign-in for omamo, then connect again. In Claude Code, type /mcp and choose Clear authentication. With mcp-remote, delete the ~/.mcp-auth folder.

The app says there are too many calls

Wait a minute, then try again.

The app says a collection is full

That is your Free plan’s limit. Remove some items, or upgrade to Pro.