Bookmarks MCP Server: Search Your Saves in Claude & Cursor

The Bookmarkjar bookmarks MCP server lets your editor's AI reach into your saved links without you ever leaving the keyboard. Picture the alternative: you're deep in a file, wiring up a database migration, and you know you bookmarked a great Drizzle guide last month. So you tab out to the browser, open your bookmark manager, search, scroll, find it, copy the link, tab back. Flow: broken.

What if your editor's AI could just reach into your bookmarks for you? You ask Claude Code "find my Drizzle notes," it calls a tool, and the links appear inline—no tab-switching, no browser.

That's exactly what the Bookmarkjar MCP server and Claude Code skill do. They turn your saved links into tools your AI assistant can call, right where you already work.

1. What Is MCP, Quickly

MCP stands for Model Context Protocol, an open standard for connecting AI assistants to external tools and data. Think of it as a universal adapter: any MCP-capable client—Claude Code, Cursor, Windsurf, and more—can call any MCP server.

Bookmarkjar runs a bookmarks MCP server of exactly this kind. It exposes your bookmarks as two callable tools—bookmarks.search and bookmarks.insert—so your assistant can query and grow your library on your behalf.

2. Why This Beats Tab-Switching

For developers and researchers, context switching is the silent productivity killer. Every trip to the browser is a chance to lose your train of thought (and get ambushed by notifications).

Bringing bookmarks into the editor changes the workflow in a few concrete ways:

• Search where you work. "What did I save about JWT rotation?" gets answered without leaving your terminal.
• Save without leaving. Found a great link in your assistant's answer? Tell it to bookmark the URL and it's filed and auto-tagged.
• Composable with everything else. Because it's a tool call, your assistant can chain it—search your bookmarks, read the page, and use it in the same turn.

3. Two Ways In: MCP Server vs. Claude Code Skill

Bookmarkjar gives you two paths, depending on your setup. They share the same backend, so pick whichever fits.

4. First: Grab an API Key

Both methods authenticate with an API key tied to your account.

1. Open Dashboard → Profile → API Keys
2. Create a new key
3. Copy it somewhere safe—you'll paste it into your editor config or shell profile next

Keys inherit your user and organization permissions, so the assistant only ever sees what you can see.

5. Setup: MCP Server

The bookmarks MCP server lives at https://bookmarkjar.com/api/tools/mcp and speaks JSON-RPC 2.0 over HTTP. Add it to your editor's MCP config.

Claude Code (VS Code)

{
  "claude.mcpServers": {
    "bookmarkjar": {
      "type": "http",
      "url": "https://bookmarkjar.com/api/tools/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Cursor

{
  "mcpServers": {
    "bookmarkjar": {
      "type": "http",
      "url": "https://bookmarkjar.com/api/tools/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

Reload the editor. Most MCP-aware IDEs (Windsurf included) accept the same mcpServers block—add an HTTP server with the URL and header. Now just ask: "search my bookmarks for agents" or "insert this URL," and the assistant calls the tools.

6. Setup: Claude Code Skill

Prefer a one-file install with a slash command? The skill needs no MCP config at all.

# 1. Create the skill directory
mkdir -p ~/.claude/skills/bookmarkjar

# 2. Save the SKILL.md file into it (full source in our docs)

# 3. Add your key to your shell profile
export BOOKMARKJAR_API_KEY="your-api-key-here"
source ~/.zshrc

Then, in Claude Code:

/bookmarkjar react hooks state management
/bookmarkjar save https://react.dev/reference/react/useState

Claude parses your intent—search vs. save—and calls the Bookmarkjar API for you. Grab the full SKILL.md source from the Claude Code skill docs.

7. The Two Tools You Get

Whichever path you choose, you're calling the same two tools.

bookmarks.search

Full-text and filtered search across your library. Useful arguments:

• search — keywords or a phrase
• tags — filter by one or more tags
• domain — limit to a domain
• type — link, image, color, or text
• limit — page size (default 5)

{
  "name": "bookmarks.search",
  "arguments": { "search": "agents", "tags": ["ai", "infra"], "limit": 5 }
}

bookmarks.insert

Create bookmarks by URL—one or many. Each new save runs through the same AI tagging pipeline, so it's instantly searchable.

{
  "name": "bookmarks.insert",
  "arguments": { "urls": ["https://example.com/a", "https://example.com/b"] }
}

8. Real Workflows This Unlocks

Once your bookmarks are a tool call away, patterns emerge:

• Research recall mid-task. "Pull up what I saved about rate limiting" while you're writing the rate limiter.
• Save-as-you-go. Ask your assistant a question, get a great source in the answer, and say "bookmark that"—filed without breaking flow.
• Batch capture. Hand it five URLs from a conversation and have them all saved and tagged in one call.
• Cross-tool memory. Pair it with AI chat on the web so your saves are reachable from both your editor and your browser.

Frequently Asked Questions

What is the Bookmarkjar MCP server?

It's a Model Context Protocol server that exposes your bookmarks as two tools—bookmarks.search and bookmarks.insert—so any MCP-capable AI client like Claude Code, Cursor, or Windsurf can search and save your links via tool calls.

How do I connect my bookmarks to Claude Code?

Two ways. Either add the MCP server to your Claude Code config as an HTTP server with your x-api-key header, or install the one-file Claude Code skill and call it with the /bookmarkjar slash command. Both use an API key from Dashboard → Profile → API Keys.

Does the MCP server work with Cursor and Windsurf?

Yes. Any MCP-aware editor accepts the same mcpServers JSON block—an HTTP server pointing at https://bookmarkjar.com/api/tools/mcp with your x-api-key header.

What's the difference between the MCP server and the Claude Code skill?

The MCP server works in any MCP client and auto-discovers tools, but needs a JSON config and editor restart. The skill is Claude Code only, installs by copying one file, uses an environment variable for auth, and runs via a slash command. You can use both at once.

Is my API key safe?

Keys inherit your own user and organization permissions, so the assistant only ever accesses bookmarks you already have access to. Store the key in your editor config or shell profile, and rotate it anytime from your dashboard.

Can the AI save bookmarks, not just search them?

Yes. The bookmarks.insert tool creates bookmarks by URL and runs them through the same AI tagging pipeline, so anything your assistant saves is immediately searchable.

Wrapping Up

Your bookmarks are most useful at the exact moment you're building something—and that's precisely when you least want to leave your editor. The bookmarks MCP server closes that gap.

Set it up once, and "find my notes on X" becomes a tool call instead of a browser detour. Your saved links finally live where your work does.

Read the full MCP setup guide or grab an API key from your dashboard and wire it into Claude Code in the next five minutes.