SSyncDev

Codex MCP Server

[![npm version](https://img.shields.io/npm/v/%40agentclientprotocol%2Fcodex-acp)](https://www.npmjs.com/package/@agentclientprotocol/codex-acp)

Local serverstdio

What is the Codex MCP Server?

npm version

What you get

codex-acp is a stdio ACP agent server. It starts the Codex App Server, translates ACP requests into Codex operations, and maps Codex events back into the client.

  • ChatGPT, API key, and client-provided custom gateway authentication
  • Model, reasoning effort, fast mode, approval, and sandbox mode configuration
  • Text prompts, embedded context, images, resource links, and additional workspace directories
  • Shell command, file change, permission request, MCP tool call, terminal output, reasoning, plan, web search, image generation, image view, token usage, and review events
  • Subagent launches as standard ACP tool calls, with Codex thread identity and activity details in namespaced _meta.codex.subagent metadata
  • Client-provided MCP servers over command-based stdio config and HTTP transport

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Codex MCP Server

{
  "mcpServers": {
    "codex": {
      "command": "npx",
      "args": ["-y", "@agentclientprotocol/codex-acp"],
      "env": {
        "CODEX_PATH": "your-value",
        "CODEX_API_KEY": "your-value",
        "OPENAI_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
CODEX_PATHFilesystem location the server is allowed to use.Optional
CODEX_API_KEYCredential the server authenticates with.Yes
OPENAI_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use Codex to Client.”
  • “Use Codex to CODEX API KEY.”
  • “Use Codex to OPENAI API KEY.”

Frequently asked questions

[![npm version](https://img.shields.io/npm/v/%40agentclientprotocol%2Fcodex-acp)](https://www.npmjs.com/package/@agentclientprotocol/codex-acp) Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Codex MCP Server

Playwright

Official

Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.

Browser AutomationTypeScript★ 21.0k

Puppeteer

Official

The original Chromium automation reference server — simple, screenshot-driven browser control.

Browser AutomationTypeScript★ 63.0k

Extensiondev

Build, run, inspect, and publish browser extensions from any MCP client. 32 tools, 13 browsers.

Browser Automation

Aluvia

The Aluvia MCP server exposes browser session management, geo-targeting, and account operations as Model Context Protocol tools for AI agents.

Browser AutomationGo

MCP Screenshot Website Fast

Fast screenshot capture tool for web pages - optimized for Claude Vision API

Browser Automation

Uindow

Uindow drives a real, signed Chromium/Electron browser with genuine OS-level input - actual cursor movement, real keystrokes, and native file dialogs rather than synthetic page events. It runs…

Browser Automation