codex-mcp-bridge
Rank #9,510io.github.hampsterx/codex-mcp-bridge
Wraps Codex CLI as MCP tools: codex, review, query, search, structured, ping, listSessions.
codex-mcp-bridge is a Model Context Protocol (MCP) server published by hampsterx. It ranks #9,510 of 121,933 servers tracked on MCP Toplist, and its repository has 3 GitHub stars. codex-mcp-bridge is listed across 3 registries — Official MCP, PulseMCP and Glama, with 4 tracked versions. It was first listed on Apr 5, 2026 and most recently updated on Aug 2, 2026.
Ranks ahead of 112,423 of 121,933 servers on MCP Toplist.
Use codex-mcp-bridge
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add codex-mcp-bridge -e "CODEX_CLI_PATH=<your CODEX_CLI_PATH>" -e "CODEX_DEFAULT_MODEL=<your CODEX_DEFAULT_MODEL>" -e "CODEX_FALLBACK_MODEL=<your CODEX_FALLBACK_MODEL>" -e "CODEX_MAX_CONCURRENT=<your CODEX_MAX_CONCURRENT>" -e "CODEX_MCP_SERVERS=<your CODEX_MCP_SERVERS>" -- npx -y codex-mcp-bridgeReplace each placeholder with your own value before saving.
[mcp_servers.codex-mcp-bridge]
command = "npx"
args = ["-y", "codex-mcp-bridge"]
[mcp_servers.codex-mcp-bridge.env]
CODEX_CLI_PATH = "<your CODEX_CLI_PATH>"
CODEX_DEFAULT_MODEL = "<your CODEX_DEFAULT_MODEL>"
CODEX_FALLBACK_MODEL = "<your CODEX_FALLBACK_MODEL>"
CODEX_MAX_CONCURRENT = "<your CODEX_MAX_CONCURRENT>"
CODEX_MCP_SERVERS = "<your CODEX_MCP_SERVERS>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"codex-mcp-bridge"
],
"env": {
"CODEX_CLI_PATH": "<your CODEX_CLI_PATH>",
"CODEX_DEFAULT_MODEL": "<your CODEX_DEFAULT_MODEL>",
"CODEX_FALLBACK_MODEL": "<your CODEX_FALLBACK_MODEL>",
"CODEX_MAX_CONCURRENT": "<your CODEX_MAX_CONCURRENT>",
"CODEX_MCP_SERVERS": "<your CODEX_MCP_SERVERS>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"codex-mcp-bridge"
],
"env": {
"CODEX_CLI_PATH": "<your CODEX_CLI_PATH>",
"CODEX_DEFAULT_MODEL": "<your CODEX_DEFAULT_MODEL>",
"CODEX_FALLBACK_MODEL": "<your CODEX_FALLBACK_MODEL>",
"CODEX_MAX_CONCURRENT": "<your CODEX_MAX_CONCURRENT>",
"CODEX_MCP_SERVERS": "<your CODEX_MCP_SERVERS>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"codex-mcp-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codex-mcp-bridge"
],
"env": {
"CODEX_CLI_PATH": "<your CODEX_CLI_PATH>",
"CODEX_DEFAULT_MODEL": "<your CODEX_DEFAULT_MODEL>",
"CODEX_FALLBACK_MODEL": "<your CODEX_FALLBACK_MODEL>",
"CODEX_MAX_CONCURRENT": "<your CODEX_MAX_CONCURRENT>",
"CODEX_MCP_SERVERS": "<your CODEX_MCP_SERVERS>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"codex-mcp-bridge"
],
"env": {
"CODEX_CLI_PATH": "<your CODEX_CLI_PATH>",
"CODEX_DEFAULT_MODEL": "<your CODEX_DEFAULT_MODEL>",
"CODEX_FALLBACK_MODEL": "<your CODEX_FALLBACK_MODEL>",
"CODEX_MAX_CONCURRENT": "<your CODEX_MAX_CONCURRENT>",
"CODEX_MCP_SERVERS": "<your CODEX_MCP_SERVERS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"codex-mcp-bridge": {
"command": "npx",
"args": [
"-y",
"codex-mcp-bridge"
],
"env": {
"CODEX_CLI_PATH": "<your CODEX_CLI_PATH>",
"CODEX_DEFAULT_MODEL": "<your CODEX_DEFAULT_MODEL>",
"CODEX_FALLBACK_MODEL": "<your CODEX_FALLBACK_MODEL>",
"CODEX_MAX_CONCURRENT": "<your CODEX_MAX_CONCURRENT>",
"CODEX_MCP_SERVERS": "<your CODEX_MCP_SERVERS>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.hampsterx%2Fcodex-mcp-bridge)<a href="https://mcptoplist.com/server/io.github.hampsterx%2Fcodex-mcp-bridge"><img src="https://mcptoplist.com/badge/io.github.hampsterx%2Fcodex-mcp-bridge.svg" alt="MCP Toplist: Top 10% of 121,933" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 3 registries
hampsterx
Other servers by hampsterx
View all hampsterx servers →Available versions (4)
| Version | Published |
|---|---|
| 0.9.1 | Aug 2, 2026 |
| 0.9.0 | Aug 2, 2026 |
| 0.8.0 | Jul 9, 2026 |
| 0.5.1 | Apr 20, 2026 |
Frequently asked questions
- Who maintains codex-mcp-bridge?
- codex-mcp-bridge is maintained by hampsterx, which publishes 3 MCP servers (14 total versions) tracked on MCP Toplist.
- Is codex-mcp-bridge listed on the Official MCP Registry?
- Yes — codex-mcp-bridge is listed on the Official MCP Registry, alongside PulseMCP and Glama.
- How many versions does codex-mcp-bridge have?
- MCP Toplist tracks 4 versions of codex-mcp-bridge, most recently published on Aug 2, 2026.
- Where can I find the source code for codex-mcp-bridge?
- The source code for codex-mcp-bridge is hosted at github.com/hampsterx/codex-mcp-bridge.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.