CrewAI

The CrewAI integration connects a Python agent to the Stagehand facade MCP server over MCP/stdio. One server process owns the browser, so page state survives across run, snapshot, and screenshot calls.

Stagehand ships this experimental integration from the repository rather than publishing it as a standalone adapter.

Prerequisites

Node.js 24 or newer
pnpm 11.10.0
Python 3.11–3.13
uv
A model-provider credential for the CrewAI agent
A current Google Chrome installation for local browser mode

Quickstart

Clone and build Stagehand

git clone https://github.com/browserbase/stagehand.git
cd stagehand
corepack pnpm@11.10.0 install --frozen-lockfile
corepack pnpm@11.10.0 exec turbo run build \
  --filter @browserbasehq/stagehand-integrations

Install the CrewAI example

cd packages/integrations/crewai
uv sync --locked

Configure the agent model

The example uses an OpenAI model by default. Keep the provider credential in the CrewAI process:

export OPENAI_API_KEY="your-openai-api-key"

Set CREWAI_MODEL to use another model supported by CrewAI.

Choose the browser

The integration uses local Chrome by default. To use Browserbase instead:

export STAGEHAND_BROWSER="browserbase"
export BROWSERBASE_API_KEY="your-browserbase-api-key"

Run a browser task

uv run python agent.py \
  "Open https://example.com and report the page title."

Configuration

Variable	Purpose
`CREWAI_MODEL`	CrewAI agent model.
`OPENAI_API_KEY`	Credential for the example’s default agent model. CrewAI does not forward it to the MCP child.
`STAGEHAND_BROWSER`	Select `local` or `browserbase`.
`BROWSERBASE_API_KEY`	Required for Browserbase.
`BROWSERBASE_PROJECT_ID`	Optional Browserbase project ID.
`STAGEHAND_MODEL_NAME`	Optional model for Stagehand AI methods called inside `run`.
`STAGEHAND_MODEL_API_KEY`	Required with `STAGEHAND_MODEL_NAME`; the MCP child does not receive agent-provider credentials.

Screenshot behavior

CrewAI’s current tool loop is text-only, and its standard MCP adapter drops image blocks. This integration saves each screenshot to a temporary file and returns the path to the agent. Open the returned path to inspect the image.

Keep the browser session alive

The example opens one MCP session around the complete CrewAI run. Keep that lifetime when adapting the example: creating a new MCP process for each tool call loses the browser and invalidates prior snapshot IDs.

run executes model-authored JavaScript in the browser. Use Browserbase for untrusted tasks and review the integration security boundary.

CrewAI integration source

Read the adapter, agent prompt, and contract tests.

First steps

The basics

Configuration

Integrations

Best practices

Migration guide

SDK reference

Prerequisites

Quickstart

Configuration

Screenshot behavior

Keep the browser session alive

CrewAI integration source

​Prerequisites

​Quickstart

​Configuration

​Screenshot behavior

​Keep the browser session alive

CrewAI integration source

Prerequisites

Quickstart

Configuration

Screenshot behavior

Keep the browser session alive