Omamo

Omamo MCP 服务

Omamo 是一款适用于 Web 的书签管理和稍后阅读应用。它的 MCP 服务可让 Claude、ChatGPT、Codex、Cursor、VS Code、Antigravity 和其他 AI 应用查找、阅读和保存你的链接与笔记。

https://omamo.app/mcp

该服务是远程服务，使用 Streamable HTTP。你通过 OAuth 使用 Omamo 账号登录，无需复制密钥。MCP（Model Context Protocol）是 AI 应用使用其他服务的标准方式。

此仓库包含设置步骤，以及 官方 MCP Registry 中条目 app.omamo/omamo 的 server.json。Omamo 是闭源的，因此此处不提供服务代码。完整指南请参阅 omamo.app/docs/mcp。

连接方式

1. 在你的 AI 应用中添加服务地址。各应用的设置步骤如下。
2. 应用会在浏览器中打开 Omamo。如果你已退出登录，请使用 Google 登录。
3. Omamo 会显示应用名称及其请求的权限。选择是否允许它进行更改，然后点击 Allow。
4. 浏览器会返回应用，应用即可使用 Omamo。

如要断开应用连接，请打开 Settings，然后在 Connected apps 下点击 Disconnect。该应用会立即失去访问权限。

设置你的应用

Claude（claude.ai 和 Claude Desktop）

1. 打开 Settings，然后选择 Connectors，再选择 Add custom connector。
2. 将名称设为 Omamo，并将 URL 设为 https://omamo.app/mcp。
3. 选择 Connect，然后登录并点击 Allow。

使用 Team 或 Enterprise 计划时，需先由所有者添加连接器。

Claude Code

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

在 Claude Code 中输入 /mcp，选择 omamo，然后选择 Authenticate。

ChatGPT

在 Settings 中的 Apps 下，使用地址 https://omamo.app/mcp 和 OAuth 登录方式添加自定义应用（MCP 服务）。部分计划可能会要求你先启用开发者模式。

Codex

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

Cursor

将以下内容添加到 ~/.cursor/mcp.json，或项目中的 .cursor/mcp.json：

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

在 Cursor 的 MCP 设置中，点击 omamo 旁边的 Connect。

VS Code

将以下内容添加到 .vscode/mcp.json：

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

点击服务上方的 Start。当 VS Code 提示时，登录。

Antigravity

打开 MCP 服务面板，选择原始配置，并将以下内容添加到 mcp_config.json：

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

仅运行本地服务的应用

使用 mcp-remote，这需要 Node.js：

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

工具

工具	功能	是否会更改内容
list_spaces	列出你所属的空间。	否
list_boards	列出某个空间中的看板。	否
list_collections	列出某个看板中的集合。	否
list_items	分页列出某个集合中的链接和笔记。	否
get_item	获取单个链接或笔记的完整内容；Pro 用户还可获取已保存链接的文章。	否
search	按关键词查找看板、集合、链接和笔记。	否
list_tags	列出某个空间中的标签。	否
list_tagged_items	列出带有某个标签的链接和笔记。	否
list_starred	列出你加星标的集合和置顶项目。	否
save_link	将网址保存到集合中。	是
create_note	在集合中创建笔记。	是
update_item	修改链接或笔记的标题、地址、文本或标签。	是
move_item	将链接或笔记移至其他集合。	是
delete_item	将链接或笔记移至回收站，可在 30 天内恢复。	是
move_items	将最多 100 个项目移至同一个集合。	是
tag_items	为最多 100 个项目添加或移除标签。	是
delete_items	将最多 100 个项目移至回收站。	是
create_board	在某个空间中创建看板。	是
update_board	重命名看板或修改其描述。	是
create_collection	在某个看板中创建集合。	是
update_collection	重命名集合或修改其描述。	是

如果你不允许应用进行更改，它只能使用前九个工具。应用永远无法删除空间、看板或集合，邀请他人，清空回收站，也无法查看你的套餐或账户信息。

安全

• 应用以你的身份操作。它能看到你在 Omamo 中看到的内容，包括其他人与你共享的空间。
• 访问令牌有效期为 15 分钟，且只能在 https://omamo.app/mcp 上使用。断开连接后，应用会立即停止运行。
• 应用每分钟最多可为你调用 120 次工具。你的套餐限制与应用中的限制相同。
• 已保存的页面和笔记可能包含旨在欺骗 AI 的文本。Omamo 会将这些内容作为数据返回。对于会更改内容的工具，请保持应用的确认功能开启。
• 已删除的链接和笔记会在回收站中保留 30 天，你可以在此期间恢复。

帮助

请在此代码库中提交问题，或发送邮件至 [email protected]。Omamo 的隐私政策和条款可在 omamo.app 上查看。