notte-mcp 1.8.20

The MCP server for Notte

⚡️ we outperform other web agents in speed, costs and reliability 👉🏼 read more on open-operator-evals

Notte MCP Server

Notte MCP Server

MCP server for all Notte tools in the agentic ecosystem.

Manage your sessions. Run agents. Take control: observe, scrape, act, authenticate.

---

[The Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) provides a standardized protocol for connecting LLM applications with external tools and data sources. It enables seamless integration between language models and the context they need, whether you're developing an AI-powered IDE, building a chat interface, or designing custom AI workflows.

Available Tools

Session Management

Tool	Description
notte_start_session	Start a new cloud browser session
notte_list_sessions	List all active browser sessions
notte_stop_session	Stop the current session

Page Interaction & Scraping

Tool	Description
notte_observe	Observe elements and available actions on the current page
notte_screenshot	Take a screenshot of the current page
notte_scrape	Extract structured data from the current page
notte_step	Execute an action on the current page

Agent Operations

Tool	Description
notte_operator	Run a Notte agent to complete a task on any website

Getting Started

1. Install the required dependencies:

pip install notte-mcp

2. Set up your environment variables:

export NOTTE_API_KEY="your-api-key"

3. Start the MCP server:

python -m notte_mcp.server

note: you can also start the dev server locally using uv run mcp dev packages/notte-mcp/src/notte_mcp/server.py --with-editable .

To use the MCP in cursor or claude computer use, you can use the following json:

check out the $HOME/Library/Application Support/Claude/claude_desktop_config.json file to see the installed MCP servers. note you might need to install the mcp-remote package using npx mcp-remote

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

Claude Desktop examples:

> Can you look for the price of airforce 1 on the nike website (men's section) ? Please show me the browser visualizer so that I can track the progress live
> Can ou check out if I have any notte session active at the moment ?

Cursor examples: