Connect Playwright MCP to Codex
Browser automation over MCP from the Playwright team. Agents use it to open the built UI, take screenshots and check layouts against the design.
MCP serverOfficialChecked 2026-11-16
Before you start
- Codex installed (see its MCP documentation (opens in a new tab)).
- Playwright MCP is available on macOS, Windows and Linux.
Step 1: Add Playwright MCP to Codex
Add it from the terminal
Saves the server to
~/.codex/config.toml, so it works in every project.Terminal codex mcp add playwright -- npx -y @playwright/mcp@latestOr edit the config file
Add this to
~/.codex/config.toml.~/.codex/config.toml [mcp_servers.playwright] command = "npx" args = ["-y", "@playwright/mcp@latest"]Step 2: Check it's connected
Terminal codex mcp listIn a Codex session, run
/mcpto see connected servers and their tools.Step 3: Try a first request
Ask Codex something that only works with Playwright MCP connected:
Say to Codex Open http://localhost:3000, take a screenshot at 375 px wide and tell me what looks broken.
If it doesn't work
- Codex reads
~/.codex/config.toml. A project.codex/config.tomlis only read in projects you have trusted. - Codex doesn't expand
~or environment variables incommand. Use a full path in the config file. - Servers that need a sign-in: run
codex mcp login <name>.





