Browserless MCP in ChatGPT

ChatGPT connects to the hosted Browserless MCP server as a custom MCP server plugin, and you sign in with your Browserless account over OAuth. Once it's connected, ChatGPT can scrape, search, crawl, and drive a cloud browser with the Browserless MCP tools.

Prerequisites

• A Browserless account for OAuth sign-in
• A ChatGPT Business, Enterprise, or Edu workspace on ChatGPT web, with permission to add custom MCP servers

Connect to the hosted server

The hosted server runs at https://mcp.browserless.io/mcp, so there's nothing to install.

ChatGPT adds remote MCP servers as custom plugins. Custom MCP servers are available on ChatGPT web, not mobile, for Business and Enterprise/Edu workspaces. On Business, only admins and owners can add them. On Enterprise/Edu, admins can grant other members permission.

1. Go to ChatGPT Plugins, click +, then Add custom MCP server.
2. Enter a name (for example Browserless) and a short description. Under Connection, enter https://mcp.browserless.io/mcp.
3. Set authentication to OAuth, review the risk warning, and select I understand and want to continue.
4. Select Create as a plugin, review the Browserless tools ChatGPT discovers, and install the plugin. Sign in with your Browserless account when ChatGPT prompts you.

To use it, start a new conversation, type @ in the prompt box, and select Browserless.

To use a region other than US West, add a browserlessUrl query parameter to the server URL, for example https://mcp.browserless.io/mcp?browserlessUrl=https://production-lon.browserless.io. See regional endpoints.

For more on how ChatGPT handles MCP servers, see OpenAI's guide to connecting an MCP server to ChatGPT.

Check the connection

Start a new conversation, type @, and select Browserless. Then ask something like "Use Browserless to fetch the title of example.com" and check that ChatGPT calls a Browserless tool.

FAQ & Troubleshooting

Can I run the Browserless MCP server locally with ChatGPT?

Use the hosted server at https://mcp.browserless.io/mcp unless you need the server to stay private. ChatGPT can't launch a local command itself, but OpenAI's Secure MCP Tunnel can reach one. Complete the tunnel setup in that guide first:

1. Create a tunnel in OpenAI Platform tunnel settings and copy its tunnel_id. Associate the tunnel with your ChatGPT workspace, or it won't appear in ChatGPT.
2. Set the runtime API key that tunnel-client uses, plus your BROWSERLESS_TOKEN for the Browserless server.
3. Run tunnel-client init with a profile name, your --tunnel-id, and --mcp-command "npx -y @browserless.io/mcp". The guide has the full command. Check the profile with tunnel-client doctor, then start tunnel-client run and keep it running.
4. In ChatGPT, add the server as above, but choose Tunnel under Connection and select your tunnel.

I don't see the option to add a custom MCP server

Custom MCP servers are only available on ChatGPT web for Business and Enterprise/Edu workspaces, so check your plan and use ChatGPT on the web. On Business, only admins and owners can add them. On Enterprise/Edu, ask an admin to grant you the Create plugins with MCPs permission.

ChatGPT doesn't list a tool I expected

ChatGPT reads the tool list when you create the plugin. If the Browserless server has added tools since, open the plugin at ChatGPT Plugins and select Refresh.

Next steps

REST API tools

Scrape, search, crawl, and export with the stateless tools

Browser agent

Drive one browser session across several turns

MCP server setup

Authentication, regional endpoints, and every other client