codex-mcp-server
MCP ServerFreeMCP server wrapper for OpenAI Codex CLI
Capabilities6 decomposed
mcp-wrapped codex cli invocation with streaming output
Medium confidenceWraps OpenAI's Codex CLI tool as an MCP server resource, translating MCP protocol calls into local CLI invocations and streaming results back through the MCP transport layer. Uses child process spawning to execute Codex commands with environment variable injection for API credentials, capturing stdout/stderr and marshaling responses into MCP-compatible JSON structures for consumption by MCP clients like Claude.
Bridges the MCP protocol standard with OpenAI's Codex CLI via stdio-based child process management, enabling Codex to be discovered and invoked as a standardized MCP resource rather than requiring direct API integration or custom CLI wrappers in each client application.
Simpler than building direct OpenAI API integrations into MCP clients because it reuses the existing Codex CLI and MCP's standard resource discovery, but slower than cloud API calls due to local process overhead.
mcp resource discovery and schema advertisement
Medium confidenceImplements the MCP server protocol to advertise Codex capabilities as discoverable resources with standardized schemas. The server registers itself with MCP clients, publishes available tools/resources with input/output schemas, and handles the MCP handshake protocol (initialization, capability negotiation) to enable clients like Claude to discover and invoke Codex without hardcoding tool definitions.
Implements full MCP server protocol compliance including resource discovery, schema publication, and capability negotiation, allowing Codex to be treated as a first-class MCP resource rather than a custom integration, enabling automatic tool discovery in MCP-aware clients.
More standardized and discoverable than custom REST API wrappers because it uses MCP's native resource advertisement, but requires MCP client support which is less universal than REST.
environment-based api credential injection for codex cli
Medium confidenceManages OpenAI API credentials by reading from environment variables (OPENAI_API_KEY) and injecting them into the Codex CLI process environment at invocation time. This approach avoids hardcoding secrets in configuration files and leverages Node.js process.env to pass credentials securely to child processes, with the MCP server acting as a credential broker between the client and the CLI.
Uses Node.js environment variable injection as the credential transport mechanism to the Codex CLI, avoiding the need for credential files or in-memory secret stores, but relying on the host environment to manage secret lifecycle.
Simpler than implementing a full credential vault but less secure than encrypted credential storage; standard practice for containerized deployments but requires careful environment variable management.
stdio-based mcp transport and bidirectional message routing
Medium confidenceImplements the MCP server using stdio (standard input/output) as the transport layer, reading JSON-RPC messages from stdin and writing responses to stdout. This enables the MCP server to run as a subprocess of an MCP client (like Claude Desktop), with message routing handled by the MCP library's event loop that deserializes incoming requests, dispatches them to handler functions, and serializes responses back to the client.
Uses stdio as the MCP transport layer, enabling the server to run as a subprocess without network configuration, leveraging the MCP library's built-in JSON-RPC message handling for request/response routing.
Simpler deployment than HTTP-based MCP servers because it avoids port binding and network configuration, but less flexible for multi-client or remote scenarios.
cli argument marshaling and parameter passing to codex
Medium confidenceTranslates MCP request parameters (passed as JSON in the MCP call) into command-line arguments for the Codex CLI, handling parameter validation, type conversion, and argument formatting. The server constructs the appropriate CLI command string with flags and options based on the MCP request, then spawns the Codex process with these arguments, enabling MCP clients to control Codex behavior through structured parameter passing rather than raw CLI strings.
Implements parameter-to-CLI-argument translation, allowing MCP clients to pass structured parameters that are converted into properly formatted Codex CLI arguments, avoiding the need for clients to understand Codex CLI syntax.
More user-friendly than requiring clients to construct raw CLI strings, but less flexible than direct API access because it's constrained by the CLI's argument interface.
subprocess output capture and response marshaling
Medium confidenceCaptures stdout and stderr from the Codex CLI subprocess using Node.js stream handlers, buffers the output, and marshals it into MCP response objects with structured metadata (exit code, execution time, error status). The server handles both successful completions and error cases, converting raw CLI output into JSON-serializable MCP responses that can be transmitted back to the client with proper error handling and status codes.
Implements comprehensive subprocess output capture with structured response marshaling, converting raw CLI output into MCP-compatible JSON responses with metadata and error handling, enabling reliable communication between the MCP client and Codex CLI.
More robust than simple stdout capture because it includes error handling and metadata, but adds complexity compared to direct API responses.
Capabilities are decomposed by AI analysis. Each maps to specific user intents and improves with match feedback.
Related Artifactssharing capabilities
Artifacts that share capabilities with codex-mcp-server, ranked by overlap. Discovered automatically through the match graph.
codex-mcp-server
MCP server wrapper for OpenAI Codex CLI
@openctx/provider-modelcontextprotocol
Use information from MCP providers
mcporter
TypeScript runtime and CLI for connecting to configured Model Context Protocol servers.
@wong2/mcp-cli
A CLI inspector for the Model Context Protocol
@bunli/plugin-mcp
MCP (Model Context Protocol) plugin for Bunli - create CLI commands from MCP tool schemas
@maz-ui/mcp
Maz-UI ModelContextProtocol Client
Best For
- ✓developers building MCP-based agent systems who want Codex as a pluggable code generation tool
- ✓teams running Claude with MCP servers and needing local code generation without cloud API dependencies
- ✓builders prototyping multi-LLM workflows where Codex specialization is valuable alongside Claude reasoning
- ✓MCP client developers integrating multiple code generation tools and needing standardized discovery
- ✓teams deploying MCP servers in heterogeneous environments where tool schemas must be machine-readable
- ✓builders creating agent systems that dynamically load tools based on MCP resource advertisements
- ✓developers deploying MCP servers in containerized or cloud environments where environment variables are the standard credential mechanism
- ✓teams using secret management systems (AWS Secrets Manager, HashiCorp Vault) that inject credentials as environment variables
Known Limitations
- ⚠Requires local Codex CLI installation and valid OpenAI API key — no fallback to cloud-only execution
- ⚠Streaming output depends on Codex CLI's own streaming capabilities; latency is bound by local process overhead (~50-200ms per invocation)
- ⚠No built-in retry logic or timeout management — failures in the CLI process propagate directly to MCP client
- ⚠Single-threaded CLI execution means concurrent requests queue sequentially, limiting throughput for high-volume code generation
- ⚠Schema advertisement is static at server startup — no dynamic schema updates without server restart
- ⚠MCP protocol overhead adds ~10-50ms per discovery/negotiation cycle compared to direct function calls
Requirements
Input / Output
UnfragileRank
UnfragileRank is computed from adoption signals, documentation quality, ecosystem connectivity, match graph feedback, and freshness. No artifact can pay for a higher rank.
Package Details
About
MCP server wrapper for OpenAI Codex CLI
Categories
Alternatives to codex-mcp-server
Are you the builder of codex-mcp-server?
Claim this artifact to get a verified badge, access match analytics, see which intents users search for, and manage your listing.
Get the weekly brief
New tools, rising stars, and what's actually worth your time. No spam.
Data Sources
Looking for something else?
Search →