MCP Servers for Codex

Codex reads its servers from ~/.codex/config.toml. Of the 54 394 we track, 20 798 answer right now without any credentials, 8 428 sign you in through the browser and 3 298 want an API key you paste into the config. The blocks below are ready to paste — each is built from the address we actually reached, in the format this client expects.

What 54 394 servers look like from Codex

Work as is answering now, no credentials asked 20 798 38.2%

Browser sign-in you authorise once, the client keeps the session 8 428 15.5%

Need a key you paste a key from the vendor into the config 3 298 6.1%

Run locally installed from a package, nothing to reach over the network 14 911 27.4%

Not responding listed as active, answer nothing 6 963 12.8%

Availability, last 24 hours share of the 39 483 remote servers answering, hour by hour

24 hours agonow

20 798

work with no key

answering now and open to anonymous clients

8 428

you authorise once, the client keeps the session

3 298

need an API key

you paste a key from the vendor into the config

14 911

run on your machine

installed from npm or PyPI, no uptime to measure

6 963

listed but dead

skip these — the registry still calls them active

How to add a server to Codex

one file for the whole machine

Open the config

One file for everything — there is no per-project variant to forget about.

open ~/.codex/config.toml

Add a section for the server

Each server is its own table. The name in brackets is what you will see when the tool is called.

[mcp_servers.example]
url = "https://example.com/mcp"

Restart the session

The file is read at start, so an already running session will not notice the change.

What it looks like

a real server, not a placeholder

~/.codex/config.toml Browser Use →

[mcp_servers.browser-use]
url = "https://api.browser-use.com/v3/mcp"

Servers to start with

all 54 394 in the catalogue →

Browser Use

by browser-use

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

1 553 680 installs/wk 7 tools answering

Playwright MCP

by microsoft

Playwright Tools for MCP

10 560 609 installs/wk local only

Firebase MCP

by firebase

Gives AI development tools Firebase-specific capabilities and expertise.

4 737 199 installs/wk local only

Storybook MCP Addon

by storybookjs

Help agents automatically write and test stories for your UI components.

3 446 933 installs/wk local only

Context7

by upstash

Up-to-date docs for AI agents

741 246 installs/wk 2 tools answering

Chrome DevTools MCP

by chromedevtools

MCP server for Chrome DevTools

1 865 622 installs/wk local only

color-space

by colorjs

Conversions across 221 color spaces, tested against cited sources: CSS strings, gamut, LUTs

1 240 890 installs/wk local only

Firecrawl MCP Server

by firecrawl

Firecrawl, the context API for AI agents: search, scrape, interact with the web, plus paper search.

168 149 installs/wk 3 tools answering

Hermoso

by hermoso-ai

AI marketing agent and AI ad generator: 1178 tools, usable alone. No model markup on Starter and up.

10 063 installs/wk 205 tools answering

Snyk

by snyk

Easily find and fix security issues in your applications leveraging Snyk platform capabilities.

786 011 installs/wk local only

Telnyx

by team-telnyx

Official TypeScript library for the Telnyx API

785 632 installs/wk local only

e2e

by tester-army

Open live web and mobile app sessions from an e2e project to inspect the app and try locators.

727 878 installs/wk local only

Browse all 54 394 servers the list is the same for every client — only the config differs

Things that trip people up with Codex

Written from how Codex reads its config, not from its release notes.

TOML, not JSON

This is the one client here that does not take JSON. Copying a block from a Cursor or VS Code example produces a parse error, not a working server — the shape is different, not just the punctuation.

One config, every project

There is no project-level file, so a server added here is present everywhere. Worth thinking about before connecting something that can write.

How is a server written in TOML?

Each server is its own table, named in square brackets, with its settings as plain keys underneath. No nesting of braces, no commas at the end of lines — the structure is flatter than the JSON equivalent, not just spelled differently.

The file was edited but nothing changed

Config is read when the session starts. An already running session keeps the old set of servers no matter what the file says now.

Which servers make sense in a terminal client?

The ones that return text rather than open a window: documentation lookup, repository context, databases, search. A server driving a real browser will work, but its output is meant to be seen.

How to check a server is alive before adding it?

Open its page here. We send a real handshake every 15 minutes and show what came back, including the case where the server is running but refuses anonymous clients.

Same servers, other clients

the servers are the same — the config format is not

Windsurf

Editor with the agent built in. Takes stdio, streamable HTTP and SSE, and can carry an OAuth login for each of the three.

~/.codeium/windsurf/mcp_config.json

Cline

Autonomous agent living inside VS Code. Handles local processes and remote endpoints over streamable HTTP or SSE, but authorisation is on you — through headers or environment variables.

~/.cline/mcp.json

Gemini CLI

Google's command-line agent. Takes all three transports and carries a full OAuth flow for remote servers, including service-account impersonation.

~/.gemini/settings.json

JetBrains AI Assistant

Built into the JetBrains IDEs. Configured through the settings dialog rather than a file, and it can import a config you already wrote for another client.

Settings | Tools | AI Assistant | Model Context Protocol

OpenCode

Open-source terminal agent. Local and remote servers sit in the same mcp object, told apart by a type field, and tokens are kept outside the config.

opencode.json in the project, or ~/.config/opencode/opencode.json

Claude Code

Adds servers by command, so nothing to edit by hand. Handles both local processes and remote endpoints, including OAuth logins.

run in your terminal

Cursor

Config sits in the project folder, so servers can differ per repository — useful when one project needs database access and another must not have it.

.cursor/mcp.json

VS Code

Works through GitHub Copilot's agent mode. Like Cursor, the config is per workspace rather than global.

.vscode/mcp.json

Claude Desktop

One global config for everything, so a server added here is available in every conversation. The file starts local servers; remote ones are added in the app under Settings → Connectors.

~/Library/Application Support/Claude/claude_desktop_config.json