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

RecommendedOne command to register and configure everything:
sh
curl -fsSL https://keenmarks.com/install.sh | sh

Requires Claude Code CLI. Already have an API key? curl -fsSL https://keenmarks.com/install.sh | sh -s -- apk_YOUR_KEY

or configure manually

Step 1. Generate an API key in your account settings.

Step 2. Add to ~/.claude.json:

~/.claude.json
{
  "mcpServers": {
    "keenmarks": {
      "type": "http",
      "url": "https://api.keenmarks.com/mcp",
      "headers": {
        "Authorization": "Bearer apk_YOUR_API_KEY"
      }
    }
  }
}

Step 3. Restart Claude Code. The keenmarks tools will appear automatically.

Cursor configuration

.cursor/mcp.json
{
  "mcpServers": {
    "keenmarks": {
      "url": "https://api.keenmarks.com/mcp",
      "headers": {
        "Authorization": "Bearer apk_YOUR_API_KEY"
      }
    }
  }
}

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
AuthAuthorization: Bearer <api_key>
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