Omamo

Omamo MCP server

Omamo is a bookmark manager and read-later app for the web. Its MCP server lets Claude, ChatGPT, Codex, Cursor, VS Code, Antigravity, and other AI apps find, read, and save your links and notes.

https://omamo.app/mcp

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

This repository holds the setup steps and the server.json of the official MCP Registry entry app.omamo/omamo. Omamo is closed source, so the server code is not here. The full guide is at omamo.app/docs/mcp.

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. If you are signed out, sign in with Google.
3. Omamo shows the app's name and what it asks for. Choose whether it can 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.

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. On some plans, ChatGPT asks you to turn on developer mode first.

Codex

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

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. When VS Code asks, sign in.

Antigravity

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

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

Apps that run only local servers

Use mcp-remote, which needs Node.js:

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

Tools

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.

Security

• The app acts as you. It sees what you see in Omamo, including spaces that other people share with you.
• Access tokens last 15 minutes and work only at https://omamo.app/mcp. Disconnect stops an app at once.
• An app can make 120 tool calls a minute for you. Your plan's limits apply, as in the app.
• Saved pages and notes can contain text written to trick an AI. Omamo returns them as data. Keep your app's confirmation on for tools that change things.
• Deleted links and notes stay in the trash for 30 days, so you can restore them.

Help

Open an issue in this repository, or write to [email protected]. Omamo's privacy policy and terms are on omamo.app.