# Notte — Browser Automation MCP for AI Agents

> MCP server that turns web browsers into AI agent tools. Notte provides structured browser actions like click, type, navigate, and extract for LLM-driven automation.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
pip install notte-mcp
```

```json
// claude_desktop_config.json
{
  "mcpServers": {
    "notte": {
      "command": "uvx",
      "args": ["notte-mcp"],
      "env": {
        "NOTTE_API_KEY": "your-key"
      }
    }
  }
}
```

Now ask your AI agent:
```
"Go to Hacker News and find the top 3 stories about AI"
"Fill out the contact form on example.com with my details"
"Take a screenshot of the dashboard after logging in"
```

## What is Notte?

Notte is an MCP server that gives AI agents structured browser automation capabilities. Instead of raw DOM manipulation, Notte provides high-level actions (click, type, navigate, extract, screenshot) that LLMs can call naturally. It handles the complexity of modern web pages — dynamic content, SPAs, popups, and authentication flows — so the AI agent can focus on the task.

**Answer-Ready**: Notte is a browser automation MCP server for AI agents. Provides structured actions (click, type, navigate, extract) that LLMs call naturally. Handles JavaScript rendering, SPAs, and auth flows. Alternative to Playwright MCP with higher-level abstractions. Growing community.

**Best for**: AI agents needing web interaction beyond scraping. **Works with**: Claude Code, Claude Desktop, Cursor, any MCP client. **Setup time**: Under 3 minutes.

## Core Tools

### 1. navigate
Go to any URL with full JavaScript rendering.

```
Agent: navigate("https://news.ycombinator.com")
```

### 2. observe
Get a structured view of the current page — clickable elements, text content, form fields.

```
Agent: observe() → returns structured page elements with IDs
```

### 3. click / type / select
Interact with page elements by ID.

```
Agent: click(element_id="submit-button")
Agent: type(element_id="search-box", text="AI tools")
Agent: select(element_id="dropdown", value="option-2")
```

### 4. extract
Pull structured data from the current page.

```
Agent: extract(schema={"title": "string", "url": "string", "points": "number"})
```

### 5. screenshot
Capture the current page state.

```
Agent: screenshot() → returns base64 image
```

## Use Cases

| Use Case | Example |
|----------|---------|
| Research | Browse sites, extract data, compile reports |
| Form Filling | Auto-fill applications, registrations |
| Testing | Navigate user flows, verify UI states |
| Data Entry | Transfer data between web applications |
| Monitoring | Check dashboards, capture status |

## Notte vs Other Browser MCPs

| Feature | Notte | Playwright MCP | Puppeteer MCP | Stagehand |
|---------|-------|----------------|---------------|-----------|
| Abstraction | High-level | Low-level | Low-level | High-level |
| observe() | Yes | No | No | Yes |
| AI-native | Yes | No | No | Yes |
| Form handling | Smart | Manual | Manual | Smart |
| Auth flows | Managed | Manual | Manual | Partial |

## FAQ

**Q: How does it handle login/auth?**
A: Notte manages browser sessions with cookies and can handle login flows. You can also pre-authenticate and reuse sessions.

**Q: Does it work with SPAs (React, Vue)?**
A: Yes, Notte waits for dynamic content to load before observing or interacting with elements.

**Q: How is it different from Playwright MCP?**
A: Playwright MCP exposes low-level browser APIs (selectors, DOM). Notte provides high-level actions that LLMs understand naturally, with built-in page observation.

## Source & Thanks

> Created by [Notte AI](https://github.com/nottelabs). Licensed under Apache 2.0.
>
> [nottelabs/notte](https://github.com/nottelabs/notte) — Browser automation for AI agents

<!-- ZH -->


## Quick Start

```json
{"mcpServers": {"notte": {"command": "uvx", "args": ["notte-mcp"]}}}
```

Let AI agents operate browsers like humans.

## What is Notte?

Notte is a browser automation MCP server that gives AI agents structured browser operations (click/type/navigate/extract). Handles SPAs, dynamic content, and authentication flows.

**In one sentence**: Browser automation MCP — AI agents interact with pages via high-level actions (click/type/navigate/screenshot), handles SPAs and auth. A higher-level alternative to Playwright MCP.

**For**: AI agent users needing web interaction.

## Core Tools

### 1. navigate — go to a URL
### 2. observe — get page structure
### 3. click/type — element interaction
### 4. extract — structured data extraction
### 5. screenshot — capture the page

## FAQ

**Q: Does it support SPAs?**
A: Yes — waits for dynamic content to load.

**Q: How is it different from Playwright MCP?**
A: Notte provides high-level abstractions that LLMs naturally understand; Playwright MCP is lower-level DOM manipulation.

## Source & Thanks

> [nottelabs/notte](https://github.com/nottelabs/notte) — Apache 2.0

---
Source: https://tokrepo.com/en/workflows/notte-browser-automation-mcp-ai-agents-6f8e3905
Author: MCP Hub