Connect Cursor to Your Bookmarks with MCP

Add the Save This One Streamable HTTP endpoint in Cursor's MCP settings and approve OAuth. Cursor can then save useful docs, search your library, and attach tags or notes without leaving the editor.

Cursor Agent can use Save This One while planning or editing code: retrieve references you saved earlier, preserve a useful docs URL, or annotate why it matters. Cursor supports remote Streamable HTTP MCP servers and handles OAuth for them.

Choose global or project configuration

Use global configuration when the library is personal and useful across repositories. In Cursor Settings → Tools & Integrations (also shown as Customize → MCP in some versions), choose New MCP Server and add this remote URL:

https://mcp.savethisone.com/mcp

The equivalent global file is ~/.cursor/mcp.json:

{
  "mcpServers": {
    "save-this-one": {
      "url": "https://mcp.savethisone.com/mcp"
    }
  }
}

For a repository-specific definition, put the same JSON in .cursor/mcp.json at the project root. Committing that file shares only the public endpoint and server name; every developer authorizes their own account. Do not add headers, access tokens, CLIENT_SECRET, or an npx mcp-remote wrapper—Save This One supports Cursor's native HTTP OAuth flow.

After saving, enable the server in Cursor's MCP settings and choose Login or Connect. Your browser opens Save This One's OAuth flow. Sign in, approve it, then return to Cursor. Desktop OAuth returns to a localhost callback; Cursor's web/cloud Agent uses a Cursor-hosted callback, so authenticate in each surface where it is requested.

Verify in the editor or CLI

In Agent chat, ask:

Use only Save This One. Call whoami, then list_tags. Make no changes.

Expand each tool call to inspect its arguments and result. Cursor asks for MCP tool approval by default.

If you use Cursor CLI, its MCP configuration is shared with the editor:

agent mcp list
agent mcp list-tools save-this-one
agent mcp login save-this-one

The tool list should contain these exact names:

save_bookmark        list_bookmarks       search_bookmarks
get_bookmark         archive_bookmark     delete_bookmark
list_tags            create_tag           delete_tag
tag_bookmarks        list_comments        add_comment
delete_comment       whoami

Workflows for Cursor

Ground a coding plan in saved sources

Before proposing the migration, search Save This One for Postgres row level security. Return at most 10 matching URLs and descriptions. Cite which saved sources informed the plan. Do not change bookmarks.

Search is case-insensitive substring matching over active bookmark metadata—not semantic search and not full article-body search. For a tag without a keyword, use list_bookmarks with the tag argument.

Keep a source used in a code change

Save https://example.com/reference with tags project-orbit and api-docs. Do not add a custom title. Report whether it was newly saved or already existed.

The server fetches title, description, site, and reading metadata. Saving an existing normalized URL changes nothing.

Link implementation context to a bookmark

Find the bookmark for the queue retry documentation. Show me the selected ID. After I confirm, add the comment “Used for retry policy in packages/jobs/src/worker.ts.”

Triage a reading backlog

List active bookmarks tagged project-orbit, 50 at a time. Suggest archive candidates, but do not archive. Include IDs so I can approve an exact set.

Approval and enterprise controls

Keep Cursor's per-call approval enabled for write tools. Avoid agent --approve-mcps or broad Auto-run rules for a server that can permanently delete data.
Expand the approval card and verify bookmarkId, tag names, comment body, and archived before allowing a call.
Prefer archive_bookmark; unarchive with the same tool and archived: false.
Never auto-approve delete_bookmark, delete_tag, or delete_comment. delete_bookmark also removes comments and tag links.
add_comment is non-idempotent. If a call times out, inspect list_comments before retrying.
Cursor's MCP allowlist and tool allowlist may restrict remote URLs or automatic execution in Enterprise. An administrator must allow https://mcp.savethisone.com/mcp if policy blocks it.
Project config is executable capability shared by a repository. Review .cursor/mcp.json changes like code, even when the entry contains only a URL.

Troubleshooting

Server is red or disconnected. Confirm the JSON is valid and the property is url, not an stdio command. In the CLI, use agent mcp list to see configuration source and transport.

No login prompt appears. Open the server in MCP settings and choose Login, or run agent mcp login save-this-one. Remove stale authentication and reconnect if the previous flow was cancelled.

Browser authorization succeeds but Desktop remains disconnected. Ensure localhost port 8787 is not blocked; Cursor documents http://localhost:8787/callback for Desktop OAuth. Cloud Agent authentication uses a different hosted callback and may need a separate login.

Tools are not under Available Tools. Enable the server, refresh it after editing JSON, and open a new Agent chat. On Enterprise, ask whether a server/tool allowlist is filtering it.

Cursor proposes a nonexistent tool. Ask it to use one exact name from the list above, or verify with agent mcp list-tools save-this-one.

Search misses an item. It may be archived. Call list_bookmarks with archived: true; for tag browsing, use an exact name returned by list_tags.

Wrong account or Unauthorized. Run whoami. If wrong, log out and re-run OAuth. If expired/revoked, use Login again rather than placing a token in mcp.json.

Give Cursor Access to Your Bookmark Library