agent-browser-mcp-codex

Expose local agent-browser capabilities as MCP tools and bootstrap Codex integration quickly.

Quick Start for Codex

Prerequisite: agent-browser must already be installed locally.

1. Run npx agent-browser-mcp-codex init-codex

2. Restart Codex or open a new session

What agent-browser already provides

agent-browser already provides a broad browser automation surface, including:

• Navigation and interaction

• Keyboard, mouse, upload, download, and scrolling controls

• Page inspection and info retrieval

• Tabs, sessions, storage, and network operations

• Debugging, diffing, recording, and streaming

• Auth, chat, dashboard, and setup commands

What this MCP wrapper currently exposes

This package currently exposes a focused subset of agent-browser commands:

• Navigation: open, back, forward, reload

• Interaction: click, fill, type

• Read and page state: get_title, get_text, get_html, snapshot, screenshot, wait

• Tabs: tab_list, tab_new, tab_close

• Runtime: eval

• Storage and network: cookies_get, network_requests

• Sessions and raw passthrough: session_current, session_list, session_close, run_raw_command

Manual Setup

If you want to wire the plugin in manually, the local Codex templates live under codex/plugin/.

Limitations

• This package currently exposes a subset of the upstream agent-browser CLI, not the full surface.

• Some tool families are intentionally narrow right now.

• Broader coverage may be added over time, but the current surface should be treated as evolving.

Development

For local verification:

• npm test

• npm run typecheck

Release

• Configure an NPM_TOKEN secret in the GitHub repository before the first automated publish.

• Create and publish a GitHub Release to trigger npm publication for the current package version.