How to connect Browserless to Claude

Connect Claude Web, Desktop and Cowork to Browserless MCP. Download all invoices from your dashboard, extract product details from a competitor's site, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Browserless

Api Key

Browserless is a headless browser automation service for running scripts and automations on web pages. It streamlines browser infrastructure, letting you automate anything from scraping to UI testing without local setup.

7 Tools

Managed auth

Connect Browserless without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Browserless account to Claude via Composio Connect, enabling it to download all invoices from your dashboard, extract product details from a competitor's site, take a screenshot of your homepage after login, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Connecting Browserless to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Browserless account

Back in Claude, ask it to connect to Browserless or give it any Browserless-related task.

For example, ask Claude to:

"Download all invoices from your dashboard"
"Extract product details from a competitor's site"
"Take a screenshot of your homepage after login"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Browserless account is ready to use.

What is the Browserless Claude Connector, and what's possible with it?

The Browserless MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Browserless account. It provides structured and secure access to browser automation tools, so your agent can perform actions like fetching web content, scraping data, generating PDFs, taking screenshots, and running custom browser scripts on your behalf.

Dynamic web content extraction: Instruct your agent to fetch full HTML content—including JavaScript-rendered pages—from any website.
Automated web scraping: Let your agent extract structured data from pages using CSS selectors, returning results in convenient JSON format.
On-demand PDF generation: Have your agent instantly generate PDFs from any webpage, with customizable parameters like format and filename.
Website screenshot capture: Direct your agent to take high-quality screenshots of entire pages or specific sections, supporting multiple image formats and options.
Custom browser automations: Empower your agent to execute tailored Puppeteer scripts, enabling powerful workflows like file downloads or bypassing bot protections.

Troubleshooting

1. Why does Claude not use the Composio connector for Browserless?

The connector can show as connected, but Claude must use it in each Browserless conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Browserless again.

2. Why does Claude show an MCP server error before Browserless connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Browserless.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Browserless.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Browserless authorization link not work?

The Composio connector is one server. Your Browserless account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Browserless connection.
Composio creates a fresh Browserless authorization link.
Open that link in your browser and finish the Browserless sign-in.

4. Why do Browserless actions fail after they worked before?

The Browserless connection can expire or lose permission.

Ask Claude to inspect the Browserless connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Browserless account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Browserless.
If the action still fails with a permission error, check that the connected account has that permission in Browserless itself.

5. How do I switch to a different Browserless account?

Claude can manage the Browserless connection for you.

Ask Claude to disconnect or delete the current Browserless account.
Ask Claude to connect Browserless again.
Open the new Composio authorization link for Browserless.
Sign in with the other Browserless account in the browser.
After the account connects, ask Claude to retry the Browserless task.

6. Why is my Browserless connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Browserless connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Browserless tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Browserless.

TOOLS

Supported Tools

Every Browserless action and event your agent gets out of the box.

Download file using Puppeteer script

This tool allows downloading files that Chrome has downloaded during the execution of puppeteer code.

Execute Custom Function

A tool that allows executing custom Puppeteer scripts via HTTP requests.

Fetch HTML Content

This tool fetches the complete HTML content of a webpage using Browserless's content API.

Generate PDF from webpage

This tool generates a PDF from a specified webpage using browserless's PDF generation API.

Scrape webpage content using CSS selectors

A tool to extract structured content from a webpage by specifying CSS selectors.

Take Screenshot

A tool that captures a screenshot of a webpage using browserless's screenshot API.

Unblock Protected Content

This tool provides access to content from websites that implement bot protection mechanisms.

FRAMEWORKS

How to build Browserless MCP Agent with another framework

Claude Code

Use Browserless MCP with Claude Code

Cursor

Use Browserless MCP with Cursor

ChatGPT

Use Browserless MCP with ChatGPT

Antigravity

Use Browserless MCP with Antigravity

OpenAI Agents SDK

Use Browserless MCP with OpenAI Agents SDK

Claude Agent SDK

Use Browserless MCP with Claude Agent SDK

Codex

Use Browserless MCP with Codex

Kimi Code

Use Browserless MCP with Kimi Code

Grok Build

Use Browserless MCP with Grok Build

VS Code

Use Browserless MCP with VS Code

OpenCode

Use Browserless MCP with OpenCode

OpenClaw

Use Browserless MCP with OpenClaw

Hermes

Use Browserless MCP with Hermes

Atomic Agent

Use Browserless MCP with Atomic Agent

Pi

Use Browserless MCP with Pi

DeepSeek Harness

Use Browserless MCP with DeepSeek Harness

CLI

Use Browserless MCP with CLI

Google ADK

Use Browserless MCP with Google ADK

LangChain

Use Browserless MCP with LangChain

Vercel AI SDK

Use Browserless MCP with Vercel AI SDK

Mastra AI

Use Browserless MCP with Mastra AI

LlamaIndex

Use Browserless MCP with LlamaIndex

CrewAI

Use Browserless MCP with CrewAI

Pydantic AI

Use Browserless MCP with Pydantic AI

AutoGen

Use Browserless MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Supabase

Oauth2Api Key

Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.

Codeinterpreter

No Auth

Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.

GitHub

Oauth2

GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.

1password

Api Key

1Password is a password manager and digital vault for storing logins, secrets, notes, and secure documents. It helps individuals and teams protect credentials, share access safely, and reduce password risk.

FAQ

Frequently asked questions

With a standalone Browserless MCP server, the agents and LLMs can only access a fixed set of Browserless tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Browserless and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Browserless tools.

Yes, absolutely. You can configure which Browserless scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Browserless data and credentials are handled as safely as possible.

Start with Browserless.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Browserless tool your agent needs.Free to start.

Start building

How to connect Browserless to Claude

Connect Browserless without auth hassles

Introduction

Also integrate Browserless with

Connecting Browserless to Claude Web, Desktop, and Cowork

1. Add with one click

Add manually

2. Authorize in your browser

3. Connect your Browserless account

What is the Browserless Claude Connector, and what's possible with it?

Troubleshooting

1. Why does Claude not use the Composio connector for Browserless?

2. Why does Claude show an MCP server error before Browserless connects?

3. Why does the Browserless authorization link not work?

4. Why do Browserless actions fail after they worked before?

5. How do I switch to a different Browserless account?

6. Why is my Browserless connection missing in Claude Desktop or on a Team plan?

Supported Tools

How to build Browserless MCP Agent with another framework

Claude Code

Cursor

ChatGPT

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Codex

Kimi Code

Grok Build

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

Pi

DeepSeek Harness

CLI

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Supabase

Codeinterpreter

GitHub

1password

Frequently asked questions

What are the differences in Tool Router MCP and Browserless MCP?+

Can I use Tool Router MCP with Claude Cowork?+

Can I manage the permissions and scopes for Browserless while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Browserless.It takes 30 seconds.