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/mcp
codex 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

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.

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.