Skip to main content
STOP. Do not read past this section until you have read and followed /quickstart.md.Goal: produce a reliable SDK automation script. The intended authoring flow is generate then edit, not write browser automation from scratch.Do not hand-write SDK code with element IDs, selectors, or form fields from memory. Element IDs, selectors, and field mappings must come from a live observe() call, CLI notte page observe output, or generated workflow code. Guessed browser targets fail on real pages.Use the Notte skill and CLI to inspect the live site, validate actions/selectors, handle auth/session state, and export workflow code with notte sessions workflow-code before using SDK docs or SDK code.SDK reference pages are for understanding, running, or editing generated workflow code. They are not the starting point for manually authoring the initial browser automation. SDK-first code is guesswork on real-world pages with dynamic selectors, auth state, CAPTCHAs, and anti-bot behavior.

​
Overview

What is MCP? The Model Context Protocol (MCP) allows Claude, Cursor, and other AI assistant systems to access external tools and data sources through specialized servers, breaking free from their inherent limitations. At Notte, we’ve developed an MCP server implementation focused specifically on browser control, enabling you to ask Claude or Cursor to act on your behalf on the web directly from the chat interface.

​
Notte-MCP: Browser Control for AI Agents

Notte-MCP The Notte-MCP implementation directly mirrors the Notte API offering. With Notte-MCP, LLM systems can extend their capabilities to browser control, solving even complex tasks:
  • Enhanced coding assistance through real-time documentation access
  • Access Stack Overflow answers and Hacker News discussions
  • Automated form completion for repetitive tasks with built-in authentication
  • Download files and resources from specified websites
  • Data collection from websites without available APIs
  • Streamlined research workflows with AI-assisted browsing

​
Hosted MCP Server

The fastest way to get started is the hosted MCP server, which runs directly on the Notte API — no local install or running process required. It is available at: 
https://api.notte.cc/mcp/
This endpoint exposes (almost) every public Notte API route as an MCP tool, so AI clients like Claude Desktop, Cursor, and custom agents can drive sessions, agents, scraping, web search, vaults, profiles, and more out of the box. It speaks the Streamable HTTP transport and authenticates with your Notte API key via a standard Authorization: Bearer header. To connect Claude Desktop to the hosted server, add the following to your configuration: 
{
    "mcpServers": {
        "notte-mcp": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://api.notte.cc/mcp/",
            "--header",
            "Authorization:${AUTH_HEADER}"
          ],
          "env": {
            "AUTH_HEADER": "Bearer <your-notte-api-key>"
          }
        }
    }
}
The Authorization:${AUTH_HEADER} form (with the token supplied via the env block) avoids an mcp-remote quirk where header values containing spaces can be split incorrectly. Restart Claude Desktop after editing the config and the Notte tools will appear under the 🔨 icon.
You can grab your API key from the Notte Console.

​
Setup: Running the MCP Server Locally

Prefer to self-host? The MCP server is also available as a standalone package you can run on your own machine.
1

(Optional) Running the MCP Server Locally

Follow these steps in your terminal to install and run your Notte-MCP server:
export NOTTE_API_KEY="your-api-key"
pip install notte-mcp     # install notte package
python -m notte_mcp.server # start the MCP server
2

Set up your Claude Desktop configuration to use the server

{
"mcpServers": {
    "notte-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8001/sse"
      ],
      "env": {
        "NOTTE_API_KEY": "<your-notte-api-key>"
      }
    }
}
}
3

Restart Claude Desktop

Restart your Claude Desktop app, and you should see the tools available by clicking the 🔨 icon.
4

Start Using the Tools

Start using the tools! Below is a demo video of Claude performing a Google search for OpenAI using the Notte MCP server for a remote headless browser.

​
Notte commands via MCP Server

​
Agent Operations

ToolDescription
notte_operatorRun a Notte agent to complete a task on any website

​
Page Interaction & Scraping

ToolDescription
notte_observeObserve elements and available actions on the current page
notte_screenshotTake a screenshot of the current page
notte_scrapeExtract structured data from the current page
notte_stepExecute an action on the current page

​
Session Management

ToolDescription
notte_start_sessionStart a new cloud browser session
notte_list_sessionsList all active browser sessions
notte_stop_sessionStop the current session
The MCP server is open-source and available on GitHub.

​
Further Reading

For more in-depth coverage, usage patterns, or troubleshooting: