|
2 | 2 | <meta charset="utf-8"> |
3 | 3 | <meta name="viewport" content="width=device-width,initial-scale=1"> |
4 | 4 | <title>Install Browser MCP for OpenAI Codex · Browser MCP</title> |
5 | | -<meta name="description" content="Run that in your terminal, load the Chrome extension once (Step 2 below), and Codex can drive your real, logged-in Chrome — your cookies, your…"> |
| 5 | +<meta name="description" content="You get an image back instead of "I don't have browser access". That's it — you're running. → What else to say"> |
6 | 6 | <link rel="canonical" href="https://browsermcp.dev/docs/install-codex/"> |
7 | 7 | <link rel="icon" type="image/svg+xml" href="/logo.svg"><link rel="icon" type="image/x-icon" href="/favicon.ico"> |
8 | 8 | <meta property="og:type" content="article"><meta property="og:site_name" content="Browser MCP"> |
9 | 9 | <meta property="og:title" content="Install Browser MCP for OpenAI Codex"> |
10 | | -<meta property="og:description" content="Run that in your terminal, load the Chrome extension once (Step 2 below), and Codex can drive your real, logged-in Chrome — your cookies, your…"> |
| 10 | +<meta property="og:description" content="You get an image back instead of "I don't have browser access". That's it — you're running. → What else to say"> |
11 | 11 | <meta property="og:url" content="https://browsermcp.dev/docs/install-codex/"> |
12 | 12 | <meta property="og:image" content="https://browsermcp.dev/og-image.jpg"><meta property="og:image:width" content="1200"><meta property="og:image:height" content="630"> |
13 | 13 | <meta name="twitter:card" content="summary_large_image"> |
14 | 14 | <meta name="twitter:title" content="Install Browser MCP for OpenAI Codex"> |
15 | | -<meta name="twitter:description" content="Run that in your terminal, load the Chrome extension once (Step 2 below), and Codex can drive your real, logged-in Chrome — your cookies, your…"> |
| 15 | +<meta name="twitter:description" content="You get an image back instead of "I don't have browser access". That's it — you're running. → What else to say"> |
16 | 16 | <meta name="twitter:image" content="https://browsermcp.dev/og-image.jpg"> |
17 | 17 | <link rel="stylesheet" href="/assets/docs.css"> |
18 | 18 | <script type="application/ld+json">{"@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{"@type": "ListItem", "position": 1, "name": "Home", "item": "https://browsermcp.dev/"}, {"@type": "ListItem", "position": 2, "name": "Docs", "item": "https://browsermcp.dev/docs/install-claude-code/"}, {"@type": "ListItem", "position": 3, "name": "Install Browser MCP for OpenAI Codex", "item": "https://browsermcp.dev/docs/install-codex/"}]}</script> |
19 | | -<script type="application/ld+json">{"@context": "https://schema.org", "@type": "TechArticle", "headline": "Install Browser MCP for OpenAI Codex", "description": "Run that in your terminal, load the Chrome extension once (Step 2 below), and Codex can drive your real, logged-in Chrome — your cookies, your…", "url": "https://browsermcp.dev/docs/install-codex/", "author": {"@type": "Organization", "name": "Agent360", "url": "https://agent360.dk"}, "publisher": {"@type": "Organization", "name": "Agent360", "url": "https://agent360.dk"}, "about": {"@type": "SoftwareApplication", "name": "Browser MCP", "applicationCategory": "DeveloperApplication", "operatingSystem": "Chrome", "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD"}}}</script> |
| 19 | +<script type="application/ld+json">{"@context": "https://schema.org", "@type": "TechArticle", "headline": "Install Browser MCP for OpenAI Codex", "description": "You get an image back instead of \"I don't have browser access\". That's it — you're running. → What else to say", "url": "https://browsermcp.dev/docs/install-codex/", "author": {"@type": "Organization", "name": "Agent360", "url": "https://agent360.dk"}, "publisher": {"@type": "Organization", "name": "Agent360", "url": "https://agent360.dk"}, "about": {"@type": "SoftwareApplication", "name": "Browser MCP", "applicationCategory": "DeveloperApplication", "operatingSystem": "Chrome", "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD"}}}</script> |
20 | 20 | <script type="application/ld+json">{"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Is this an official OpenAI integration?", "acceptedAnswer": {"@type": "Answer", "text": "No — Browser MCP is an independent, open-source MCP server built by Agent360. It works with Codex because Codex speaks the standard Model Context Protocol, not because of any special partnership."}}, {"@type": "Question", "name": "Do I need Claude Code installed to use this with Codex?", "acceptedAnswer": {"@type": "Answer", "text": "No. codex mcp add writes straight to Codex's own ~/.codex/config.toml — nothing about this path touches Claude Code at all."}}, {"@type": "Question", "name": "Is my browsing data safe? What does the extension see?", "acceptedAnswer": {"@type": "Answer", "text": "Everything stays local. The extension talks to an MCP server on 127.0.0.1 on your own machine — nothing is sent to any external server, no telemetry, no analytics. Cookies and tokens are only pulled when your agent explicitly asks for them, one call at a time. Source is open and auditable on GitHub."}}, {"@type": "Question", "name": "How does CAPTCHA assistance actually work?", "acceptedAnswer": {"@type": "Answer", "text": "Three layers: (1) auto-detect and click reCAPTCHA/hCaptcha/Turnstile checkboxes, (2) AI-vision-guided grid solving for image challenges, (3) browser_ask_user shows you the challenge to solve by hand if the first two miss — then the agent continues. Nothing is routed through a third-party CAPTCHA-solving service. We publish no solve-rate figure - we haven't benchmarked it rigorously enough to stand behind one."}}, {"@type": "Question", "name": "Is it really free?", "acceptedAnswer": {"@type": "Answer", "text": "Yes — MIT-licensed, open source, no paywall, no account, no API key. Built by Agent360 as part of its developer-tools work."}}, {"@type": "Question", "name": "How do I remove it?", "acceptedAnswer": {"@type": "Answer", "text": "codex mcp remove browser-mcp drops the entry from config.toml, then remove the extension from chrome://extensions. There's no global npm install to clean up — npx runs the server directly each time, it's never installed persistently."}}, {"@type": "Question", "name": "What if I already have Browser MCP set up for Claude Code?", "acceptedAnswer": {"@type": "Answer", "text": "The Chrome extension is shared — you only load it once, regardless of how many MCP clients point at it. You just need one more codex mcp add (or manual config.toml entry) so Codex knows about the same local server. --- by Agent360 · MIT License · GitHub · npm"}}]}</script> |
21 | 21 | </head><body><div class="top"><div class="top-in"><a class="logo" href="/" style="color:inherit"><span class="m">✦</span> Browser MCP</a><a class="star" href="https://github.com/Agent360dk/browser-mcp" style="color:inherit;text-decoration:none">GitHub ↗</a></div></div><div class="shell"><nav class="side"><div class="grp">Docs</div><a href="/docs/install-claude-code/">Claude Code</a><a href="/docs/install-codex/" class="active">Codex</a><a href="/docs/install-cursor/">Cursor</a><a href="/docs/install-vscode/">VS Code</a><a href="/docs/install-zcode/">ZCode</a><a href="/docs/what-is-browser-mcp/">What is Browser MCP</a><a href="/docs/tools/">Tools</a><a href="/docs/uninstall/">Uninstall & data</a><a href="/docs/when-not-to-use/">When NOT to use</a><a href="/docs/troubleshooting/">Troubleshooting</a><div class="grp">Compare</div><a href="/compare/browsermcp-io/">vs browsermcp.io</a><a href="/compare/playwright-mcp/">vs Playwright MCP</a><a href="/compare/browser-automation-mcp-servers/">All servers compared</a><a href="/compare/mcp-chrome/">vs mcp-chrome</a><div class="grp">Use cases</div><a href="/use-cases/read-2fa-from-gmail/">Read a 2FA code from Gmail</a><a href="/use-cases/concurrent-sessions/">Concurrent sessions</a><div class="grp">Learn</div><a href="/learn/model-context-protocol/">Model Context Protocol</a><a href="/learn/what-is-an-mcp-server/">What is an MCP server</a><a href="/learn/check-if-ai-mentions-your-brand/">Check if AI mentions you</a><a href="/learn/browser-automation-react-forms/">Automating React forms</a></nav><main class="content"><h1 id="install-browser-mcp-for-openai-codex">Install Browser MCP for OpenAI Codex</h1> |
22 | | -<div class="code"><pre>codex mcp add browser-mcp -- npx @agent360/browser-mcp</pre><button class="copy">Copy</button></div> |
23 | | -<p>Run that in your terminal, load the Chrome extension once (Step 2 below), and Codex can drive your real, logged-in Chrome — your cookies, your sessions, your 2FA — instead of a blank headless browser that gets blocked on every login wall.</p> |
| 22 | +<p><b>Give Codex control of your real, already-logged-in Chrome — about 90 seconds, four steps.</b> Your cookies, your sessions, your 2FA, instead of a blank headless browser that gets blocked on every login wall.</p> |
| 23 | +<h2 id="the-whole-thing-in-four-steps">The whole thing, in four steps</h2> |
| 24 | +<p><b>1 — Install the Chrome extension.</b> One click from the <a href="https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl">Chrome Web Store</a>; Chrome keeps it updated. No store? The unpacked install is further down.</p> |
| 25 | +<p><b>2 — Add the MCP server to Codex.</b> Paste this in a terminal. Required — the extension does nothing on its own:</p> |
| 26 | +<div class="code"><pre>codex mcp add browser-mcp -- npx @agent360/browser-mcp@latest</pre><button class="copy">Copy</button></div> |
| 27 | +<p><b>3 — Restart your Codex session.</b> That is what starts the server. The extension icon turns green.</p> |
| 28 | +<p><b>4 — Say this, to check it worked.</b> Paste it to Codex:</p> |
| 29 | +<blockquote>Take a screenshot of my current Chrome tab.</blockquote> |
| 30 | +<p>You get an image back instead of <i>"I don't have browser access"</i>. <b>That's it — you're running.</b> → <a href="#now-what-things-to-actually-say">What else to say</a></p> |
| 31 | +<p>Everything below is the long version.</p> |
24 | 32 | <h2 id="install-3-steps-90-seconds">Install — 3 steps (~90 seconds)</h2> |
25 | 33 | <h3 id="step-1-add-the-mcp-server-to-codex">Step 1: Add the MCP server to Codex</h3> |
26 | | -<div class="code"><pre>codex mcp add browser-mcp -- npx @agent360/browser-mcp</pre><button class="copy">Copy</button></div> |
| 34 | +<div class="code"><pre>codex mcp add browser-mcp -- npx @agent360/browser-mcp@latest</pre><button class="copy">Copy</button></div> |
27 | 35 | <p>This writes a <code>[mcp_servers.browser-mcp]</code> entry to <code>~/.codex/config.toml</code> (Codex's own config command does the writing — you don't touch the file by hand). If you'd rather edit it yourself, the entry looks like this:</p> |
28 | 36 | <div class="code"><pre>[mcp_servers.browser-mcp] |
29 | 37 | command = "npx" |
|
0 commit comments