Convert MCP servers from Codex to Claude Code

Got MCP servers working in Codex and want the same ones in Claude Code? The servers don't change, only the config wrapper does. Here's exactly what to change.

Where each file lives

• Codex: ~/.codex/config.toml (or .codex/config.toml in a trusted project)
• Claude Code: .mcp.json in the project, or ~/.claude.json

Before and after

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env = { API_KEY = "..." }

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {"API_KEY": "..."}
    }
  }
}

What changes

Each [mcp_servers.NAME] table becomes a key under mcpServers. Inline tables like env = {...} become plain JSON objects. Codex-only fields such as startup_timeout_sec or bearer_token_env_var have no direct match, so you'll have to handle them yourself.

Open the converter set to Claude Code → Paste your Codex config, copy the result. It runs in your browser and nothing gets uploaded.

Double-check before you paste the result anywhere: if your config has tokens in it, they'll be in the output too.

Other conversions

VS Code → Claude Code · Codex → Claude Desktop · Codex → Cursor · Codex → VS Code

All guides · Free tools · FAQ · Browse all 346 plugins