Metadata-Version: 2.4
Name: notte-mcp
Version: 1.6.9
Summary: The MCP server for Notte
Author-email: Notte Team  <hello@notte.cc>
Requires-Python: >=3.11
Requires-Dist: mcp[cli]>=1.6.0
Requires-Dist: notte-sdk==v1.6.9
Requires-Dist: python-dotenv>=1.0.1
Description-Content-Type: text/markdown

<div align="center">
  <p>
    ⚡️ we outperform other web agents in speed, costs and reliability 👉🏼 <a href="https://github.com/nottelabs/open-operator-evals">read more on open-operator-evals</a>
  </p>
</div>

<p align="center">
  <img src="../../docs/logo/bgd.png" alt="Notte Logo" width="100%">
</p>

# Notte MCP Server

<div align="center">
  <h1>Notte MCP Server</h1>
  <p><em>MCP server for all Notte tools in the agentic ecosystem.</em></p>
  <p><strong>Manage your sessions. Run agents. Take control: observe, scrape, act, authenticate.</strong></p>
  <hr/>
</div>
[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:
```bash
pip install notte-mcp
```

2. Set up your environment variables:
```bash
export NOTTE_API_KEY="your-api-key"
```

3. Start the MCP server:
```bash
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`
```json
{
  "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:
