← All guides

Locus product guide · Updated

Best Codex MCP servers and how to add them

Good first MCP servers for Codex are the ones OpenAI's Codex docs use as examples: Context7 for library docs, Playwright and Chrome DevTools for the browser, GitHub, Sentry, Figma and the OpenAI Docs MCP. Add a remote server with codex mcp add name --url, a local one with codex mcp add name -- command, and sign in with codex mcp login. Servers live in ~/.codex/config.toml, shared by the CLI, the IDE extension and the ChatGPT desktop app. The old codex mcp-server command has been removed.

Setup, step by step

  1. Step 1

    Add a remote server

    Pass a name and the server URL. This example adds the official Alpha Vantage server.

    codex mcp add alphavantage --url https://mcp.alphavantage.co/mcp
  2. Step 2

    Sign in if the server uses OAuth

    Codex opens your browser for the sign-in and stores the token. Alpha Vantage asks for your free API key during this step.

    codex mcp login alphavantage
  3. Step 3

    Add a local server

    Codex starts local servers as a process. This is the command from the Playwright MCP README.

    codex mcp add playwright npx "@playwright/mcp@latest"
  4. Step 4

    Or add servers in the ChatGPT desktop app

    Open Settings, then MCP servers, then Add server. Pick STDIO or Streamable HTTP, enter the command or URL, save, and select Restart. Type /mcp in the composer to see what is connected.

Which MCP servers should you add to Codex?

Start with the servers that match your daily work. Commands come from each project's docs and the Codex MCP docs, checked on November 10, 2026.

Which MCP servers should you add to Codex?
ServerJobCodex commandKey or sign-in
Context7Current library docscodex mcp add context7 --url https://mcp.context7.com/mcpNone; a free key raises rate limits
PlaywrightBrowser automation and testscodex mcp add playwright npx "@playwright/mcp@latest"No key
Chrome DevToolsConsole, network and performancecodex mcp add chrome-devtools -- npx chrome-devtools-mcp@latestNothing to sign up for
GitHubRepos, issues and pull requestscodex mcp add github --url https://api.githubcopilot.com/mcp/ --bearer-token-env-var GITHUB_PAT_TOKENPersonal access token in GITHUB_PAT_TOKEN
FirecrawlWeb search, scrape and parsecodex mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcpNo key within daily limits
Alpha VantageStock prices and fundamentalscodex mcp add alphavantage --url https://mcp.alphavantage.co/mcpFree key, 25 requests a day
Locus ProPaid APIs from one balancecodex plugin marketplace add locus-technologies/locus-pro-plugin, then codex plugin add locus@locusLocus account, browser sign-in

Can Codex itself run as an MCP server?

Not anymore. OpenAI removed the codex mcp-server command and the standalone codex-mcp-server binary. Integrations that launched either one must move before they upgrade Codex.

The replacement is the Codex app server. It speaks its own JSON-RPC protocol, so it is not a drop-in MCP server, and OpenAI marks it experimental and not supported for production. Connecting Codex to outside MCP servers with codex mcp works as before.

Which config.toml options matter for MCP servers?

Each server is a [mcp_servers.name] table in config.toml. A project can have its own .codex/config.toml, which Codex reads only in trusted projects. These options keep servers fast and safe.

  • enabled_tools and disabled_tools: an allow list and a deny list. The deny list applies after the allow list.
  • default_tools_approval_mode: auto, prompt, writes or approve. writes prompts for any tool not marked read-only.
  • tool_timeout_sec: defaults to 60 seconds. Raise it for slow tools such as browser agents.
  • startup_timeout_sec: defaults to 10 seconds for a server to start.
  • enabled = false turns a server off without deleting it.
  • bearer_token_env_var: reads a token from an environment variable instead of the file.

Should you install a Codex plugin or a plain MCP server?

A plugin bundles skills and MCP servers, so the agent gets the tools and instructions on when to use them. Type /plugins in the Codex CLI to browse them. ChatGPT and Codex share one plugin directory. The IDE extension does not support plugins, so use plain MCP servers there.

OpenAI's curated marketplace in the openai/plugins repo held 65 plugins on November 10, 2026, including GitHub, Linear, Figma, Stripe, Vercel, Sentry, Supabase, Notion, Cloudflare, Datadog and PostHog. Plugins from GitHub marketplaces install the same way. Matt Pocock's skills, for example, install with codex plugin marketplace add mattpocock/skills and codex plugin add mattpocock-skills@mattpocock.

How do you give Codex paid APIs through Locus Pro?

Install the Locus plugin and sign in once. Codex then searches the catalog, checks each price and calls the API from one credit balance, with no key per vendor. The setup guide has the exact commands and login scopes.

Prices below are live catalog prices. Prices checked November 10, 2026. 1,000 credits equal $1. Long results come back as a continuation that the agent fetches with get_call_result, so a slow call does not have to fit inside the 60-second default timeout.

  • An Alpha Vantage free key covers 25 requests a day. If that is enough, add the Alpha Vantage server on its own.
How do you give Codex paid APIs through Locus Pro?
JobLocus endpointCredits per callCost
Cited search answerperplexity/search5.8$0.0058
Web searchparallel/search1 to 15.2$0.001 to $0.0152
Work email from a name and domainhunter/email-finder1 to 10.1Up to $0.0101
Company fundamentalsalphavantage/company-overview5.1 fixed$0.0051
Google results for a keyworddataforseo/serp-google-organic2 to 14,140, usually 2Usually $0.002

How do you choose MCP servers for Codex?

Pick by the work, not the hype. Each server adds tools to every session, so remove the ones you stop using.

  • Coding against fast-moving libraries: Context7.
  • Front-end and test work: Playwright, or Chrome DevTools for debugging.
  • Repo work from the terminal: GitHub, with the token kept in an environment variable.
  • Same setup in the CLI, the IDE extension and the desktop app: plain MCP servers in config.toml.
  • Skills plus tools in one install: a plugin, outside the IDE extension.
  • Paid data from several vendors on one bill: Locus Pro.

Frequently asked questions

Where does Codex store MCP servers?

In config.toml, by default the one in the .codex folder in your home directory. A trusted project can add its own .codex/config.toml. The CLI, the IDE extension and the ChatGPT desktop app all read the same file.

Does Codex support remote MCP servers with OAuth?

Yes. Codex connects to Streamable HTTP servers with a bearer token or OAuth, including Client ID Metadata Documents and dynamic client registration. Run codex mcp login with the server name to sign in.

Can I stop Codex from running MCP tools without asking?

Yes. Set default_tools_approval_mode to prompt for a server, or to writes so that only tools not marked read-only ask first. You can also set an approval mode for a single tool.

What replaced codex mcp-server?

The Codex app server. It uses its own JSON-RPC protocol and is not an MCP server, so integrations must be rewritten for it. OpenAI calls it experimental and not supported for production.

Implementation references

Use these first-party references for current request contracts and account requirements. Tool availability, prices, and negotiated terms can change.

Sources

Third-party details were checked on November 10, 2026. Vendors change pricing and features often, so confirm on their site before you decide.

Related guides