Install

Notte offers three installation paths depending on how you intend to use it: the Python SDK for scripting agents, the CLI for interactive and shell-based automation, and the MCP server for wiring Notte into Claude, Cursor, or Windsurf.

Python SDK

pip install notte
patchright install --with-deps chromium

Requires Python 3.10+. The patchright step installs the patched Chromium binary that Notte uses for anti-detection. You only need to run it once per environment.

After installing, set your API key:

export NOTTE_API_KEY="your-api-key-here"

Get a free key at https://console.notte.cc.

Notte-SDK (Cloud API Client)

For cloud-only usage without local Chromium:

pip install notte-sdk

CLI

On macOS/Linux via Homebrew:

brew tap nottelabs/notte-cli https://github.com/nottelabs/notte-cli.git
brew install notte

Via Go (any platform with Go 1.21+):

go install github.com/nottelabs/notte-cli/cmd/notte@latest

After installing, authenticate:

notte auth login
notte auth status

MCP Server (Claude / Cursor / Windsurf)

pip install notte-mcp

Configure the MCP server in your editor's settings file pointing to notte-mcp as the executable. The MCP server exposes Notte browser sessions and agents as tools that the host LLM can call directly.

Agent Skills (Claude Code, Cursor, Goose, OpenHands)

npx skills add nottelabs/notte-skills

This pulls the official Notte skill definitions into your agent framework, enabling agents to call structured Notte workflows without writing raw SDK code.

Starter Templates

Ready-to-use shell-script templates are available in the notte-skills repository:

Template	Path
Form Automation	plugins/notte-cli/skills/notte-browser/templates/form-automation
Authenticated Session	plugins/notte-cli/skills/notte-browser/templates/authenticated-session
Data Extraction	plugins/notte-cli/skills/notte-browser/templates/data-extraction

Browse them at https://github.com/nottelabs/notte-skills/tree/main/plugins/notte-cli/skills/notte-browser/templates/