Integration

Claude Code MCP Server for Bookmarks (2026 Setup, 2 min)

Beginner 2 minutes setup By David Hamilton Updated

Claude Code is Anthropic’s command-line interface for Claude. It runs in your terminal, reads your codebase, and can use MCP servers to connect to external tools and data — including your ContextBolt bookmarks.

This integration is particularly useful for developers who save technical content across Twitter/X, Reddit, and LinkedIn. Instead of context-switching to your browser to look up that article about caching strategies or that Reddit thread about Kubernetes networking, you can ask Claude Code to search your bookmarks directly from the terminal.

Why ContextBolt MCP matters for coding workflows

Developers hoard bookmarks. Tweets about architectural patterns, Reddit discussions about library trade-offs, LinkedIn posts about scaling lessons. The problem is finding them when you actually need them.

With the Claude Code integration, your saved content becomes part of your coding context. You’re debugging a tricky issue, and you remember saving something relevant last month — just ask Claude Code to find it. The search is semantic, so you describe what you’re looking for in plain language rather than trying to remember exact keywords.

This is especially powerful because Claude Code already understands your codebase. It can combine what it knows about your code with what you’ve saved, making your bookmarks genuinely useful during development rather than collecting dust in a browser sidebar.

Claude Code: configuration file alternative

If you prefer editing config files directly, create or edit .mcp.json in your project root:

{
  "mcpServers": {
    "bookmarks": {
      "type": "http",
      "url": "https://api.contextbolt.app/mcp/YOUR_TOKEN"
    }
  }
}

Two things worth flagging from when we set this up internally. First, Claude Code requires "type": "http" for remote servers. Leave it out and the connection fails silently. Second, if you commit .mcp.json to a public repo, swap the token for ${CONTEXTBOLT_MCP_TOKEN} and set the env var locally; Claude Code expands ${VAR} references automatically. The full reference, including OAuth and header auth, lives in the Claude Code MCP docs.

Claude Code MCP tips for developers

Search before you search the web. Before reaching for Google or Stack Overflow, check your bookmarks. You’ve already curated high-quality content — use it first.

Combine with code context. Ask Claude Code something like “I’m refactoring the auth module. Do I have any saved content about OAuth best practices?” Claude can connect your bookmarks to the code it’s looking at.

Use platform filters for technical content. Reddit saves tend to be deep technical discussions. Twitter saves tend to be quick tips and opinions. Filtering by platform helps narrow results when you know where you saved something.

How to connect ContextBolt to Claude Code

  1. Get your MCP token from ContextBolt

    Open the ContextBolt extension popup in Chrome and click Settings. Under the MCP section, click 'Copy MCP Token'. MCP is a Pro feature ($6/month) and your bookmarks must be syncing to the cloud (toggle in the same settings panel). The token looks like a UUID.

  2. Add ContextBolt via the CLI

    Open your terminal and run: claude mcp add --transport http --scope user bookmarks https://api.contextbolt.app/mcp/YOUR_TOKEN. Replace YOUR_TOKEN with the token you copied. The --scope user flag makes the server available across every project; drop it for the current project only.

  3. Test the connection

    Run claude mcp list and you should see bookmarks listed with a connected status. Then start a new Claude Code session and ask 'Search my bookmarks for articles about API design'. Claude will call the ContextBolt tools and return matching bookmarks.

Example prompts for ContextBolt + Claude Code

Once connected, try asking Claude Code:

Search my bookmarks for anything about database migrations

While working on a migration, pull in articles and threads you previously saved about migration strategies, rollback patterns, or schema versioning.

What did I save about React server components?

When building a feature, surface your saved reference material without leaving the terminal. Claude searches semantically, so it finds relevant content even with different wording.

Find my Reddit saves about Rust error handling

Filter by platform and topic. Useful when you saved a detailed Reddit discussion months ago and want to reference it mid-session.

I'm debugging a rate limiter. Do I have any saved content about rate limiting patterns?

Use this pattern when you're stuck. Claude searches your bookmarks for anything related to your current problem and brings relevant saves into the conversation.

What you can do with ContextBolt in Claude Code

Search bookmarks by meaning during coding sessions

Filter by platform (Twitter, Reddit, LinkedIn)

Pull saved reference material into terminal conversations

Access bookmarks from any project directory

Combine bookmark search with code analysis in the same session

Works alongside other MCP servers you have configured

ContextBolt + Claude Code: FAQs

What's the difference between project-level and user-level MCP config? +
User-level (--scope user) registers the server in your global Claude Code config and makes it available in every project you open. Project-level (the default --scope local, or editing .mcp.json directly) keeps it scoped to one repo, which is useful if you want to commit a shared config for a team. For ContextBolt, user-level is usually right since you want your bookmarks everywhere.
Can I add ContextBolt by editing a config file instead of the CLI? +
Yes. Create or edit .mcp.json in your project root with: {"mcpServers": {"bookmarks": {"type": "http", "url": "https://api.contextbolt.app/mcp/YOUR_TOKEN"}}}. The "type": "http" field is required; omitting it makes Claude Code treat it as a stdio server and the connection fails silently. To avoid committing the token, use ${CONTEXTBOLT_MCP_TOKEN} and set the env var locally.
Do I need Node.js installed? +
No. ContextBolt's MCP server is hosted, not local. Claude Code talks to it over HTTPS, so there is no npx, no Node.js dependency, and no process running on your machine. You only need Claude Code itself.
Can Claude Code modify my bookmarks? +
No, it can't modify or delete your bookmarks. Claude Code can search and retrieve them, and since the May 2026 update it can also create new ones with the save_bookmark tool. So it can add saves, but it can't change or remove what is already there.
How do I check if the server is connected? +
Run claude mcp list to see all configured servers and their status. Inside an interactive session, type /mcp to see connection state and which tools each server exposes.