Developer docs · MCP Server

MCP Bookmark Server

KeenMarks exposes your bookmark library as an MCP server (Model Context Protocol). Connect Claude Code, Cursor, or any MCP-compatible client to save and search bookmarks without leaving your IDE.

Quick start

Run this command in your terminal to add KeenMarks to Claude Code:

sh
claude mcp add --scope user keenmarks --transport http https://api.keenmarks.com/mcp

Requires Claude Code CLI. The --scope user flag registers the server globally, so it's available in every project.

What happens next

  1. The keenmarks server registers in Claude Code.
  2. The first time Claude calls a keenmarks tool, your browser opens the KeenMarks authorization page.
  3. Enter your email — a 6-digit code is sent to your inbox. Enter the code to authorize.
  4. Done. All future calls are authenticated automatically.

Cursor

Cursor supports MCP via .cursor/mcp.json. Add the entry below — OAuth authorization will trigger on first use.

.cursor/mcp.json
{
  "mcpServers": {
    "keenmarks": {
      "url": "https://api.keenmarks.com/mcp"
    }
  }
}

Available tools (8)

ToolDescriptionArguments
add_bookmarkSave a URL. AI tags and summary generated async.url, title?, description?, tags?
search_bookmarksFull-text search across titles, descriptions, and tags.query, limit?
list_bookmarksList recent bookmarks with optional tag/unread filter.limit?, tag?, unread_only?
get_bookmarkGet full details of a single bookmark.id
delete_bookmarkPermanently delete a bookmark.id
tag_bookmarkReplace the tag list on a bookmark.id, tags[]
list_tagsList all tags sorted by bookmark count.limit?
mark_readClear the unread flag on a bookmark.id

Protocol details

TransportStreamable HTTP (MCP spec 2025-03-26)
EndpointPOST https://api.keenmarks.com/mcp
ProtocolJSON-RPC 2.0
AuthOAuth 2.0 Authorization Code + PKCE (RFC 7636)
DiscoveryGET https://api.keenmarks.com/.well-known/oauth-authorization-server
SSE streamGET https://api.keenmarks.com/mcp (heartbeat every 25s)

Example: save a link from Claude Code

You say to Claude:

“Save this link for me: https://react.dev/reference/react/useCallback — tag it react and hooks”

Claude calls:

tool call
add_bookmark({
  url: "https://react.dev/reference/react/useCallback",
  tags: ["react", "hooks"]
})

Response:

result
Bookmark saved (id: bm_xK9mP2).
AI tags and summary will be generated shortly.
URL: https://react.dev/reference/react/useCallback

Ready to connect your AI agent?

MCP server access requires a Pro plan ($9/year). Start with 500 free bookmarks.

Create account — start freeSee Pro features