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 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/YOUR_TOKEN"That is the whole entry. Because your token sits in the URL path, there is no headers block and no auth section to fill 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. With cloud sync switched off in the extension, the server connects, reports healthy, and returns nothing for every query. It looks exactly like a broken config and is not.
Turn sync on in the extension settings, wait a minute for the 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.
Your MCP URL carries a personal token, so treat config.toml like any other file holding a credential and keep it out of public repos. The ContextBolt bookmarks overview covers what the library does, and connect Claude to your bookmarks walks the same setup in a different terminal agent.
How to connect ContextBolt to Codex
-
Get your MCP token from ContextBolt
Open the ContextBolt extension popup and click Settings. Under the MCP section, click Copy MCP Token. MCP is a Pro feature ($6/month) and cloud sync must be enabled in the same panel, otherwise the server returns nothing.
-
Add it to config.toml
Open ~/.codex/config.toml and add a server block: [mcp_servers.bookmarks] on one line, then url = "https://api.contextbolt.app/mcp/YOUR_TOKEN" on the next. Codex uses TOML rather than JSON, so this is not a config you can paste from another client.
-
Start a fresh session
Codex reads the config at session start, so an already-running session will not pick up the change. Quit and start a new one, then ask 'what bookmark tools do you have?' to confirm the server loaded.
-
Verify with a real query
Ask 'search my bookmarks for anything about caching strategies'. If it returns saves from X, Reddit, or LinkedIn, you are live. If it returns nothing at all, check cloud sync is on in the extension rather than assuming the config is wrong.
Example prompts for ContextBolt + Codex
Once connected, try asking Codex:
Semantic search across every platform at once, without leaving the terminal you are already working in.
Puts material you already vetted into the agent's context before it starts changing code.
Calls get_recent_bookmarks, useful for a Monday catch-up on what you flagged and never came back to.
Calls save_bookmark, so something you find mid-task goes into the library without a context switch.
What you can do with ContextBolt in Codex
Search saved 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