Notte Browser MCP

Connect your AI assistant to cloud browsers with Notte Browser MCP

AI agent instructions

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.

Notte Browser MCP gives your AI assistant cloud browsers for navigating websites, interacting with pages, extracting data, and reusing saved logins. Browser sessions consume credits while active, so stop them when your task is finished.

Connect Notte Browser MCP

Connect your client to the hosted MCP endpoint:

https://api.notte.cc/mcp

Clients that support OAuth can prompt you to sign in with your Notte account and choose a workspace. For clients or scripts that use bearer authentication, create a Notte API key.

Claude Code

Add the server, then run /mcp in Claude Code and authenticate with your Notte account:

claude mcp add --transport http notte https://api.notte.cc/mcp

If you prefer an API key, add the header explicitly:

claude mcp add --transport http notte https://api.notte.cc/mcp --header "Authorization: Bearer $NOTTE_API_KEY"

Codex

Add this to ~/.codex/config.toml or your project’s .codex/config.toml

[mcp_servers.notte]
url = "https://api.notte.cc/mcp"
bearer_token_env_var = "NOTTE_API_KEY"

Cursor

Open your MCP settings and add:

{
  "mcpServers": {
    "notte": {
      "url": "https://api.notte.cc/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NOTTE_API_KEY}"
      }
    }
  }
}

Claude Desktop

Open Settings > Connectors > Add custom connector. Use Notte Browser MCP as the name and enter:

https://api.notte.cc/mcp

Connect, sign in with your Notte account, and choose the workspace Claude should use. You can use the same custom-connector flow on claude.ai.

Others

Add this to your MCP configuration:

{
  "mcpServers": {
    "notte": {
      "url": "https://api.notte.cc/mcp",
      "headers": {
        "Authorization": "Bearer <your-notte-api-key>"
      }
    }
  }
}

Browser tools

The browser workflow is manage_browsers(start) → browser_action(goto) → browser_observe → act and observe again → manage_browsers(stop).

The three page-reading tools are read-only. Management tools group inspection with state-changing actions and are marked as write tools, so your client may request confirmation even for their list or get actions.

Tool	Permission hint	Actions or purpose
manage_browsers	Write	start, list, status, stop
browser_observe	Read	Read page state, tabs, and available element IDs
browser_scrape	Read	Extract page markdown or structured data
browser_screenshot	Read	Capture the current viewport
browser_action	Write	Navigate, click, fill forms, and interact with pages
manage_files	Write	upload, list_uploads, get_upload, list_downloads, get_download
manage_profiles	Write	create, list, get, duplicate, delete
manage_auth	Write	list, get, check, reauthenticate

To save a login, create a profile with manage_profiles, then start a browser with both profile_id and persist_profile=true. Stop the browser to save its state; before reusing it, check persisted_domains with manage_profiles(action="get").

Verify the connection

Run this prompt in your assistant:

Use Notte Browser MCP to start a browser, navigate to https://example.com, observe the page, and extract its heading as structured JSON. Report the result and stop the browser when finished, including if any step fails.

Other Notte MCP endpoints

For the broader developer API, including function and agent administration, use https://api.notte.cc/mcp/full. It accepts the same OAuth sign-in or Notte API key. The browser connector at /mcp does not expose those administration tools.

Anything API has its own MCP endpoint at https://anything.notte.cc/mcp for finding, running, and building reusable APIs.

Notte Documentation MCP

You can also configure the Notte Docs MCP to give your coding agent current documentation while it helps you build. It needs no API key.

https://docs.notte.cc/mcp

Claude Code

Run this command and verify the connection with claude mcp list

claude mcp add --transport http notte-docs https://docs.notte.cc/mcp

Codex

Add this to ~/.codex/config.toml or your project’s .codex/config.toml

[mcp_servers.notte_docs]
url = "https://docs.notte.cc/mcp"

Cursor

Open your MCP settings and add:

{
  "mcpServers": {
    "notte-docs": {
      "url": "https://docs.notte.cc/mcp"
    }
  }
}

Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "notte-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.notte.cc/mcp"
      ]
    }
  }
}

Others

Add this to your MCP configuration:

{
  "mcpServers": {
    "notte-docs": {
      "url": "https://docs.notte.cc/mcp"
    }
  }
}