Browserbase tool CLI for AI Agents

Use Composio Universal CLI with Browserbase tool. Start a new headless browser session now, download all artifacts from last session, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Browserbase tool

Api Key

Browserbase is a serverless platform for running and managing headless browsers at scale. It lets you automate and monitor browser tasks with Playwright, Puppeteer, and Selenium—no infrastructure headaches.

24 Tools

Managed auth

Connect Browserbase tool without auth hassles

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

Book a call

Explore the MCP Gateway

Introduction

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP.

With Composio's Universal CLI, your coding agents can talk to over 1500+ SaaS applications. With Browserbase tool, agents can start a new headless browser session now, download all artifacts from last session, retrieve debug urls for active sessions, and more — all without worrying about authentication.

This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Browserbase tool automation.

Also integrate Browserbase tool with

Claude Code Claude Cowork OpenAI Agents SDK Claude Agent SDK Muse Codex Kimi Code OpenClaw Hermes Atomic Agent Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

What is Universal CLI and why use it?

The idea behind building the universal CLI is to give agents a single command interface to interact with all your external applications. Here's what you'll get with it:

Agent-friendly: Coding agents like Claude Code, Codex, and OpenCode can use CLI tools natively — no MCP setup required.
Authentication handled: Connect once via OAuth or API Key, and all CLI commands work with your credentials automatically.
Tool discovery: Search, inspect, and execute 20,000+ tools across 1500+ apps from one interface.
Trigger support: Use triggers to listen for events across your apps, powered by real-time webhooks or polling under the hood.
Type generation: Generate typed schemas for autocomplete and type safety in your projects.

Prerequisites

Install the Composio CLI, authenticate, and initialize your project:

bash

# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Authenticate with Composio
composio login

During login you'll be redirected to sign in page, finish the complete flow and you're all set.

Connecting Browserbase tool to Coding Agents via Universal CLI

Once it is installed, it's essentially done. Claude Code, Codex, OpenCode, OpenClaw, or any other agent will be able to access the CLI. A few steps to give agents access to your apps.

Launch your Coding Agent — Claude Code, Codex, OpenCode, anything you prefer.
Prompt it to "Authenticate with Browserbase tool"
Complete the authentication and authorization flow and your Browserbase tool integration is all set.
Start asking anything you want.

Universal CLI Commands for Browserbase tool

You can also manually execute CLI commands to interact with your Browserbase tool.

Connect your Browserbase tool account

Link your Browserbase tool account and verify the connection:

bash

# Connect your Browserbase tool account (opens OAuth flow)
composio connected-accounts link browserbase_tool

# Verify the connection
composio connected-accounts list --toolkits browserbase_tool

Discover Browserbase tool tools

Search and inspect available Browserbase tool tools:

bash

# List all available Browserbase tool tools
composio tools list --toolkit browserbase_tool

# Search for Browserbase tool tools by action
composio tools search "browserbase tool"

# Inspect a tool's input schema
composio tools info BROWSERBASE_TOOL_LIST_PROJECTS

Common Browserbase tool Actions

List Browserbase Projects — List projects with their default timeout and assigned concurrency

bash

composio tools execute BROWSERBASE_TOOL_LIST_PROJECTS

List Recording Downloads — Poll per-page MP4 assembly after requesting recording downloads until every page is COMPLETED or FAILED

bash

composio tools execute BROWSERBASE_TOOL_LIST_RECORDING_DOWNLOADS \
  --id "<string>"

List Browser Sessions — List browser sessions, optionally filtered by status or user metadata

bash

composio tools execute BROWSERBASE_TOOL_LIST_SESSIONS \
  --status "<string>" \
  --metadata_query "<string>"

Create Browser Context — Create a reusable browser context; the API key can select the project

bash

composio tools execute BROWSERBASE_TOOL_CREATE_CONTEXT \
  --name "<string>" \
  --projectId "<string>"

Create Browser Session — Create an isolated Browserbase session and return its connection details

bash

composio tools execute BROWSERBASE_TOOL_CREATE_SESSION \
  --region "<string>" \
  --proxies "<string>" \
  --timeout "<integer>" \
  --keepAlive "<boolean>"

Update Browser Context — Tool to update a specific browser context

bash

composio tools execute BROWSERBASE_TOOL_CONTEXTS_UPDATE \
  --id "ctx_123abc"

Delete a browser context — Tool to delete a browser context and all its stored data (cookies, localStorage, etc

bash

composio tools execute BROWSERBASE_TOOL_DELETE_CONTEXT \
  --id "ctx_abcdef123456"

Delete a browser extension — Tool to delete an uploaded browser extension by its ID

bash

composio tools execute BROWSERBASE_TOOL_DELETE_EXTENSION \
  --id "bc8075c3-f292-42bf-9aec-aca62f1d9099"

Generate Type Definitions

Generate typed schemas for Browserbase tool tools to get autocomplete and type safety in your project:

bash

# Auto-detect language
composio generate --toolkits browserbase_tool

# TypeScript
composio ts generate --toolkits browserbase_tool

# Python
composio py generate --toolkits browserbase_tool

Tips & Tricks

Always inspect a tool's input schema before executing: composio tools info <TOOL_NAME>
Pipe output with jq for better readability: composio tools execute TOOL_NAME -d '{}' | jq
Set COMPOSIO_API_KEY as an environment variable for CI/CD pipelines
Use composio dev logs tools to inspect execution logs and debug issues

Next Steps

Try asking your coding agent to perform various Browserbase tool operations
Explore cross-app workflows by connecting more toolkits
Set up triggers for real-time automation
Use composio generate for typed schemas in your projects

TOOLS

Supported Tools

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

Update Browser Context

Tool to update a specific browser context.

Create Browser Context

Create a reusable browser context; the API key can select the project.

Create Browser Session

Create an isolated Browserbase session and return its connection details.

Delete a browser context

Tool to delete a browser context and all its stored data (cookies, localStorage, etc.

Delete a browser extension

Tool to delete an uploaded browser extension by its ID.

Delete Session Downloads

Tool to delete all file downloads from a specific browser session.

Download Session Artifacts

Download a completed session's generated files as a ZIP archive.

Get Browser Context

Return metadata for a browser context by ID.

Retrieve a browser extension

Tool to retrieve details of a specific browser extension.

Get Browserbase Project

Return project metadata, default timeout, and assigned concurrency.

Get project usage statistics

Tool to retrieve usage statistics for a project including browser minutes and proxy bytes consumed.

Get Browser Session

Return status, connection details, and timestamps for a browser session.

Get Session Debug URLs

Return live debugger and WebSocket URLs for a running browser session.

Get Session Logs

Return network request and response events captured during a browser session.

Get Session Replay

Return HLS replay metadata and page playlist paths for a recorded session.

Get Session Replay Page

Return the HLS M3U8 playlist for one recorded replay page.

List Browserbase Projects

List projects with their default timeout and assigned concurrency.

List Recording Downloads

Poll per-page MP4 assembly after requesting recording downloads until every page is COMPLETED or FAILED.

List Browser Sessions

List browser sessions, optionally filtered by status or user metadata.

Release Browser Session

Irreversibly request release of a running browser session, ending it before its configured timeout to avoid further charges.

Request Recording Downloads

Start asynchronous MP4 assembly for every recorded page of a completed session, then poll List Recording Downloads until every page is COMPLETED or FAILED.

Upload Browser Extension

Tool to upload a browser extension for use in sessions.

Upload Session File

Upload one file so browser interactions can select it in a file input field.

Upload Session Files

Upload multiple files to one browser session for file-input interactions.

FRAMEWORKS

How to build Browserbase tool MCP Agent with another framework

Claude Code

Use Browserbase tool MCP with Claude Code

Claude Cowork

Use Browserbase tool MCP with Claude Cowork

OpenAI Agents SDK

Use Browserbase tool MCP with OpenAI Agents SDK

Claude Agent SDK

Use Browserbase tool MCP with Claude Agent SDK

Muse

Use Browserbase tool MCP with Muse

Codex

Use Browserbase tool MCP with Codex

Kimi Code

Use Browserbase tool MCP with Kimi Code

OpenClaw

Use Browserbase tool MCP with OpenClaw

Hermes

Use Browserbase tool MCP with Hermes

Atomic Agent

Use Browserbase tool MCP with Atomic Agent

Google ADK

Use Browserbase tool MCP with Google ADK

LangChain

Use Browserbase tool MCP with LangChain

Vercel AI SDK

Use Browserbase tool MCP with Vercel AI SDK

Mastra AI

Use Browserbase tool MCP with Mastra AI

LlamaIndex

Use Browserbase tool MCP with LlamaIndex

CrewAI

Use Browserbase tool MCP with CrewAI

Pydantic AI

Use Browserbase tool MCP with Pydantic AI

AutoGen

Use Browserbase tool 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

The Composio Universal CLI is a single command-line interface that lets coding agents and developers interact with 1500+ SaaS applications. It handles authentication, tool discovery, action execution, and trigger setup — all from the terminal, without needing to configure MCP servers.

Any coding agent that can run shell commands works with the Composio CLI — including Claude Code, Codex, OpenCode, OpenClaw, and others. Once the CLI is installed, agents automatically discover and use the composio commands to interact with Browserbase tool and other connected apps.

MCP servers require configuration and can be token-heavy for complex workflows. The CLI gives agents a direct, lightweight interface — no server setup needed. Agents simply call composio commands like any other shell tool. It's faster to set up, more reliable for multi-step tool chaining, and works natively with how coding agents already operate.

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 Browserbase tool data and credentials are handled as safely as possible. You can also bring your own OAuth credentials for full control.

Start with Browserbase tool.It takes 30 seconds.

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

Start building

Browserbase tool CLI for AI Agents

Connect Browserbase tool without auth hassles

Introduction

Also integrate Browserbase tool with

What is Universal CLI and why use it?

Prerequisites

Connecting Browserbase tool to Coding Agents via Universal CLI

Universal CLI Commands for Browserbase tool

Connect your Browserbase tool account

Discover Browserbase tool tools

Common Browserbase tool Actions

List Browserbase Projects — List projects with their default timeout and assigned concurrency

List Recording Downloads — Poll per-page MP4 assembly after requesting recording downloads until every page is COMPLETED or FAILED

List Browser Sessions — List browser sessions, optionally filtered by status or user metadata

Create Browser Context — Create a reusable browser context; the API key can select the project

Create Browser Session — Create an isolated Browserbase session and return its connection details

Update Browser Context — Tool to update a specific browser context

Delete a browser context — Tool to delete a browser context and all its stored data (cookies, localStorage, etc

Delete a browser extension — Tool to delete an uploaded browser extension by its ID

Generate Type Definitions

Tips & Tricks

Next Steps

Supported Tools

How to build Browserbase tool MCP Agent with another framework

Claude Code

Claude Cowork

OpenAI Agents SDK

Claude Agent SDK

Muse

Codex

Kimi Code

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Supabase

Codeinterpreter

GitHub

1password

Frequently asked questions

What is the Composio Universal CLI?+

Which coding agents work with the Composio CLI?+

How is the CLI different from using an MCP server for Browserbase tool?+

How safe is my Browserbase tool data when using the Composio CLI?+

Start with Browserbase tool.It takes 30 seconds.