ContextBolt in Codex · 3 minutes · Beginner

Codex MCP for Bookmarks (2026 Setup, 3 min)

One server block in config.toml, and the Codex CLI reads your saves.

Add to Chrome
Free extension · the AI connection is on Pro, $6/mo
Bookmarks MCP server for Claude, Cursor & Codex Codex · 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. Use the right ContextBolt account Sign into the extension with your account email and email code. If Pro is not active yet, save your license key once in Settings under Account. Let cloud sync finish. Use this same email when connecting your AI app.
  2. Add the remote server Run codex mcp add bookmarks --url https://api.contextbolt.app/mcp. This saves the server in Codex's MCP configuration.
  3. Log in from Codex Run codex mcp login bookmarks. Sign in on the ContextBolt page with your Pro extension account email, enter the email code, and approve the connection.
  4. Check the connection Start a fresh chat or session and ask what bookmark tools are available. If the library looks empty, check that the extension and the AI connection use the same email, Pro is active, and cloud sync has finished.

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 queue architecture” Semantic search across every platform at once, without leaving the terminal you are already working in.
“Find my saves about this library, then use them to guide the refactor” Puts material you already vetted into the agent's context before it starts changing code.
“What have I saved in the last week?” Calls get_recent_bookmarks, useful for a Monday catch-up on what you flagged and never came back to.
“Save this URL to my bookmarks” Calls save_bookmark, so something you find mid-task goes into the library without a context switch.

What it can do in Codex.

  • Search saved web pages, tweets, Reddit posts and LinkedIn content by meaning
  • Pull saved material into an agent task before it writes code
  • Filter by platform when you remember where you saved something
  • Browse your automatic topic clusters
  • Save new links to your library from the terminal
  • Works alongside any other MCP servers in config.toml

The longer story.

Connect with OAuth. Use https://api.contextbolt.app/mcp, then sign in with your Pro extension account email, enter the email code, and approve access. Existing personal URLs still work for older clients. Full setup and recovery help.

OpenAI’s Codex ships MCP support across the CLI and the desktop app, so you can connect your ContextBolt library and search everything you have saved, web pages included, on X, Reddit, and LinkedIn without leaving the terminal.

The config.toml block

Codex configures everything in TOML, MCP servers included. Open ~/.codex/config.toml:

[mcp_servers.bookmarks]
url = "https://api.contextbolt.app/mcp"

Then run codex mcp login bookmarks. Sign in with the same email as your Pro extension account, enter the email code, and approve the connection. Adding this shared URL alone does not finish sign-in.

The thing to watch is that this is genuinely different from every JSON-based client. There is no mcpServers object to paste into, so a config that works in Cursor or Claude Code gives you nothing to copy here. The section header [mcp_servers.bookmarks] is the part people get wrong, and a malformed header is skipped silently rather than throwing an error.

Start a fresh session

Codex reads config.toml when a session starts. If you edit the file while a session is open, nothing happens and it looks like the config failed.

Quit, start a new session, and ask “what bookmark tools do you have?” before concluding anything is broken.

If it loads but finds nothing

MCP reads from your synced library. Check that Codex and the extension use the same account email, your account has active Pro, and its automatic cloud sync has finished.

Confirm the Pro badge is green in the extension, wait a minute for the first upload, then retry.

Why this is useful in a terminal agent

Codex works across a whole repo, often for a long stretch without you watching closely. Anything that improves the context it starts from pays off across the entire task.

Ground the work first: ask it to check your bookmarks for relevant patterns before it starts refactoring, so the changes build on material you already trust rather than on whatever it infers from the code alone.

Catch up on what you flagged: get_recent_bookmarks covers the “what did I save this week and never read” problem in one question.

Save without breaking flow: find something useful mid-task and it goes into the library with save_bookmark.

The shared OAuth URL is not a secret. If you use a private personal URL for compatibility instead, keep that credential out of public repositories. The ContextBolt bookmarks overview covers what the library does, and connect Claude to your bookmarks walks the same setup in a different terminal agent.

Common questions.

Why TOML instead of JSON?

Codex uses config.toml for everything, MCP servers included, so there is no JSON block to copy from a Cursor or VS Code setup. The structure is [mcp_servers.NAME] as a section header, then url on its own line. Getting the section header syntax right is the main thing people trip on.

I added the server but the tools aren't there

Run codex mcp login bookmarks and complete the email-code sign-in in your browser. Adding the server is only the first step. Then start a fresh Codex session and check /mcp.

The server loads but returns nothing

Check that Codex and the extension are signed into the same email, your account has Pro, and cloud sync has finished. An empty result alone does not prove a connection problem.

Can Codex modify or delete my bookmarks?

No. It can search and retrieve, and it can create new bookmarks with save_bookmark. It cannot change or delete anything already in your library, which matters when you are letting an agent work autonomously across a repo.

Does this work in both the Codex CLI and the desktop app?

Yes. Codex ships MCP support across the CLI and the desktop app, and both read the same config.toml. Because ContextBolt is a remote server that does nothing client-specific, the tools behave identically in each.

Go deeper: ContextBolt in Claude Code · ContextBolt in Gemini CLI · ContextBolt in Cursor · 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