Skip to main content
Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.
Connect the OpenAI Agents SDK to Notte Browser MCP. The example creates a browser, lets an OpenAI agent read a page, and closes the browser when the run finishes or raises an error.

Install

For Python 3.11+, run pip install notte-sdk openai-agents==0.24.0. For Node.js 24+, run npm install notte-sdk @openai/agents@0.20.0 openai@7.34.0 zod. Set NOTTE_API_KEY to your Notte API key and OPENAI_API_KEY to your OpenAI API key.

Run an agent

Save the Python example as notte_openai_agents.py and run python notte_openai_agents.py. For TypeScript, save it as notte_openai_agents.ts in a project with "type": "module" and run node --experimental-strip-types notte_openai_agents.ts.
Both examples print Example Domain. The application owns the session and exposes browser_action, browser_observe, and browser_scrape. browser_action can also click elements and fill forms. Closing the MCP connection alone does not stop a browser; the outer Notte session scope handles cleanup. OpenAI tracing is disabled for this example. See Notte Browser MCP for the available tools and session lifecycle for longer-lived browsers.