Connect Browserbase to Your AI Agent

Organize session statuses and resource usage before managing a cloud browser session.

Try a Browserbase Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Browserbase

Review session activity and usage

Summarize browser minutes, proxy traffic and selected session states.

/oo Browserbase: Read Browserbase usage for project [ID] and list sessions matching [status or metadata filter]. Summarize browser minutes, proxy bytes, session statuses and expiry times. Inspect session [ID] if needed. Preserve the scope of each metric and do not invent a billing amount.

Create a browser session

Prepare a session with your chosen project, region and timeout.

/oo Browserbase: Create a Browserbase session in project [ID], region [region], with timeout [seconds] and keep-alive [true/false]. Attach existing context [ID, or none] with persistence [choice] if requested. Return the session ID, status and expiry; do not navigate pages.

Start Working with Browserbase

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Browserbase

Connect with a Browserbase API key and default project ID.
Connect Browserbase →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

The key must have access to the project you intend to use.
Releasing a session is a request; check its status afterward.

Browserbase Tools

Read Browserbase project usage and session records, create sessions, and request their release. This connection manages session resources; browser navigation and page interaction require a separate browser control tool.

Usage and session records

Read project consumption and cloud browser session details.

Session resources

Create sessions and contexts, inspect contexts and request session release.

11 tools

List Projects

List the Browserbase projects visible to the current API key.

browserbase.list_projects

Get Project

Get one Browserbase project by project identifier.

browserbase.get_project

Get Project Usage

Get Browserbase browser minute and proxy byte usage for one project, defaulting to the connected project.

browserbase.get_project_usage

Create Context

Create a Browserbase context and return the upload credentials for an encrypted user-data directory.

browserbase.create_context

Get Context

Get one Browserbase context by context identifier.

browserbase.get_context

Refresh Context Upload Credentials

Refresh the Browserbase upload credentials for an existing context so a new encrypted archive can be uploaded.

browserbase.refresh_context_upload_credentials

Delete Context

Delete one Browserbase context by context identifier.

browserbase.delete_context

Create Session

Create a Browserbase session using the connected project by default, with optional context reuse and persistence.

browserbase.create_session

List Sessions

List Browserbase sessions with optional status or metadata query filters.

browserbase.list_sessions

Get Session

Get one Browserbase session by session identifier.

browserbase.get_session

Request Session Release

Request that Browserbase releases a session before timeout by sending status REQUEST_RELEASE.

browserbase.request_session_release

Frequently Asked Questions

What usage can I summarize?

Project usage includes browser minutes and proxy bytes. Keep those figures separate from session-level details and from monetary charges.

Can a new session reuse an existing context?

Yes, provide its context ID and whether session updates should persist to it. Creating or inspecting a context does not itself upload browser data.

Can this connection click through a website?

It creates and manages Browserbase session resources. It does not include page navigation, clicking, form filling or extraction actions.