notte-mcp 1.5.2

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 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:

{
    "mcpServers": {
        "notte-mcp": {
            "url": "http://localhost:8000/sse",
            "env": {
                "NOTTE_API_KEY": "<your-notte-api-key>"
            }
        }
    }
}

For integration in Claude Desktop, you can run the following command:

# Make sure that NOTTE_API_KEY is set in your .env file
uv run fastmcp install src/notte_mcp/server.py -f .env
uv run mcp install src/notte_mcp/server.py -v NOTTE_API_KEY=$NOTTE_API_KEY

check out the $HOME/Library/Application Support/Claude/claude_desktop_config.json file to see the installed MCP servers.

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: