ContextBolt in Gemini CLI · 3 minutes · Beginner

Gemini CLI MCP for Bookmarks (2026 Setup)

One httpUrl entry in settings.json, and Gemini CLI reads your saves.

Add to Chrome
Free extension · the AI connection is on Pro, $6/mo
Bookmarks MCP server for Claude, Cursor & Codex Gemini CLI · ContextBolt connected example library
What did I save about rate limiting?
Used search_bookmarks
Token buckets beat fixed windows for bursty trafficX · @dan_abramov
How we rate limit 40k req/s on one boxReddit · u/pgstash
Rate limiting is a product decision, not a configPriya Patel
Searched 847 saves across X, Reddit and LinkedIn

5.0 on the Chrome Web Store Trusted by 300+ users across the globe
WORKS WITH

It connects in 3 minutes.

  1. Prepare your account Sign in to the ContextBolt extension, activate Pro, and let cloud sync finish.
  2. Add the shared server URL In ~/.gemini/settings.json, add bookmarks under mcpServers with httpUrl set to https://api.contextbolt.app/mcp.
  3. Sign in to ContextBolt Run /mcp auth bookmarks in Gemini CLI. Enter your ContextBolt Pro account email and email code, then allow the connection.
  4. Check the tools Ask the agent what ContextBolt tools it has. Check authentication if the list is empty.

The guide covers every client and the compatibility options. How the connection works

Then ask it something real.

“Search my bookmarks for what I saved about API versioning” Semantic search across your saved pages, X, Reddit and LinkedIn at once, without leaving the terminal.
“Find my saves about this framework before you scaffold anything” Puts material you already vetted into context so the generated code follows patterns you chose.
“What did I save this month about hiring?” Calls get_recent_bookmarks with a window, good for picking up threads you flagged and never returned to.
“What are my bookmark clusters?” Calls list_clusters, which gives you an honest picture of what you have actually been collecting.

What it can do in Gemini CLI.

  • Search saved web pages, tweets, Reddit posts and LinkedIn content by meaning
  • Pull saved material into a task before code gets written
  • Filter by platform when you remember where you saved something
  • Browse your automatic topic clusters
  • Save new links to your library from the terminal
  • Confirm the connection any time with /mcp

The longer story.

Gemini CLI speaks MCP, so you can connect your ContextBolt library and search everything you have saved, web pages included, on X, Reddit, and LinkedIn from the terminal.

The settings.json entry

Open ~/.gemini/settings.json for a global setup, or .gemini/settings.json in a repo root to scope it to one project:

{
  "mcpServers": {
    "bookmarks": {
      "httpUrl": "https://api.contextbolt.app/mcp"
    }
  }
}

The field is httpUrl, not url. Gemini CLI is the odd one out here: Cursor, Claude Code, and Kiro all use url, Antigravity and Windsurf use serverUrl, VS Code uses url with an explicit type, and Gemini CLI wants httpUrl.

A config copied from any of those parses fine and gives you no tools. If nothing shows up after setup, this field is the reason far more often than anything else.

Confirm with /mcp

Start Gemini CLI and run /mcp auth bookmarks. Enter your Pro account email and email code, then allow the connection. Run /mcp to check it. It lists every connected server along with the tools each one exposes.

This is more reliable than asking the model what tools it has, because a model can happily tell you it has bookmark access when the server never loaded. /mcp reads the actual connection state.

If /mcp lists it but queries come back empty

MCP reads from your synced library. With cloud sync switched off in the extension, everything looks correct: the server connects, /mcp lists it with all its tools, and every search returns nothing.

Confirm the Pro badge is green in the extension, give the first upload a minute, then retry. Check this before you start editing the config, because the symptoms point somewhere else entirely.

Working patterns

Ground the task first: ask it to check your bookmarks for relevant patterns before it scaffolds anything, so what it generates follows approaches you already chose.

Pick up dropped threads: get_recent_bookmarks answers “what did I save this month and never read” in one question.

See what you actually collect: list_clusters gives an honest picture of where your reading attention has gone.

The shared server URL contains no personal key. Each user signs in separately. Older personal URLs remain a compatibility option and must stay private. The ContextBolt bookmarks overview covers what the library does, and connect Claude to your bookmarks walks the same setup in a different agent.

Common questions.

Is it url or httpUrl?

httpUrl. Gemini CLI uses httpUrl for a remote HTTP MCP server, where Cursor, Claude Code, and Kiro all use url. A config copied from any of those looks correct and produces no tools. If nothing appears after setup, check this field before anything else.

Where should settings.json live?

~/.gemini/settings.json makes the server available in every project. .gemini/settings.json in a repo root scopes it to that project only. The shared OAuth URL contains no personal key, so each user signs in separately. If you use an older personal URL instead, keep that secret out of the repository.

How do I check the server actually connected?

Run /mcp inside Gemini CLI. It lists every connected server with the tools each one exposes, which is more reliable than asking the model what tools it has. If bookmarks is listed with its tools, the connection is good and any problem is elsewhere.

It's connected but returns nothing

Check the sync in the extension. MCP reads from your synced library, so before the first upload finishes the server connects, /mcp lists it happily, and every query comes back empty. Sync runs on its own once Pro is active; confirm the Pro badge is green, wait a minute, then retry.

Can Gemini delete my bookmarks?

No. It can search and retrieve, and it can create new bookmarks with save_bookmark. It cannot modify or delete anything already in your library, so an agent working unattended cannot damage what you have saved.

Go deeper: ContextBolt in Codex · ContextBolt in Claude Code · ContextBolt in Antigravity · Add Your Bookmarks to Claude Code via MCP · What Is MCP? AI Protocol Explained · all integrations

Give your AI
your library.

Free up to 150 bookmarks. Pro adds the AI connection, unlimited bookmarks, export and sync, for $6 a month.

Add to Chrome See everything ContextBolt does