Skip to main content

The MCP server for Notte

Project description

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

Notte Logo

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
  1. Set up your environment variables:
export NOTTE_API_KEY="your-api-key"
  1. 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:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

notte_mcp-1.6.4.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

notte_mcp-1.6.4-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file notte_mcp-1.6.4.tar.gz.

File metadata

  • Download URL: notte_mcp-1.6.4.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.13

File hashes

Hashes for notte_mcp-1.6.4.tar.gz
Algorithm Hash digest
SHA256 227a3acd866c49a28761de12420656c03f53fad8a61f5b1da597da5c8fddd1cb
MD5 7b48ab9b890fe06a1e16d77d8a2436cf
BLAKE2b-256 45dd3a797a3e079bc2f148ee414f8cdb4868dd7f0b1a1eb09e167e3db6949759

See more details on using hashes here.

File details

Details for the file notte_mcp-1.6.4-py3-none-any.whl.

File metadata

  • Download URL: notte_mcp-1.6.4-py3-none-any.whl
  • Upload date:
  • Size: 5.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.13

File hashes

Hashes for notte_mcp-1.6.4-py3-none-any.whl
Algorithm Hash digest
SHA256 f4e2762f04f180208717f0401f0a3d31f00ae6262d3e7bcc2170f32e5eabfebc
MD5 70f4d0d5d6f52e50e4539171289b4977
BLAKE2b-256 cc2f89fe7a5abb44cb76d490984231d86a9cae7fcf778c4f730c91964e894e8d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page