> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Notte Browser MCP

> Connect your AI assistant to cloud browsers with Notte Browser MCP

<Tip>
  Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.
</Tip>

Notte Browser MCP gives your AI assistant cloud browsers for navigating websites, interacting with pages, extracting data, and reusing saved logins. Browser sessions consume credits while active, so stop them when your task is finished.

## Connect Notte Browser MCP

Connect your client to the hosted MCP endpoint:

```text theme={null}
https://api.notte.cc/mcp
```

Clients that support OAuth can prompt you to sign in with your Notte account and choose a workspace. For clients or scripts that use bearer authentication, create a [Notte API key](https://console.notte.cc/apikeys).

<Tabs>
  <Tab title="Claude Code" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/claude-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=5b5633b0bc4a9d14f2f12ed39abe527e" width="24" height="24" data-path="images/claude-logo.svg">
    Add the server, then run `/mcp` in Claude Code and authenticate with your Notte account:

    ```bash theme={null}
    claude mcp add --transport http notte https://api.notte.cc/mcp
    ```

    If you prefer an API key, add the header explicitly:

    ```bash theme={null}
    claude mcp add --transport http notte https://api.notte.cc/mcp --header "Authorization: Bearer $NOTTE_API_KEY"
    ```
  </Tab>

  <Tab title="Codex" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/openai-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=22739a70b7a68530abf78ef043985584" width="24" height="24" data-path="images/openai-logo.svg">
    Add this to `~/.codex/config.toml` or your project's `.codex/config.toml`

    ```toml theme={null}
    [mcp_servers.notte]
    url = "https://api.notte.cc/mcp"
    bearer_token_env_var = "NOTTE_API_KEY"
    ```
  </Tab>

  <Tab title="Cursor" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/cursor-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=010084e587443335f794f13615c5191a" width="24" height="24" data-path="images/cursor-logo.svg">
    Open your MCP settings and add:

    ```json theme={null}
    {
      "mcpServers": {
        "notte": {
          "url": "https://api.notte.cc/mcp",
          "headers": {
            "Authorization": "Bearer ${env:NOTTE_API_KEY}"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/claude-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=5b5633b0bc4a9d14f2f12ed39abe527e" width="24" height="24" data-path="images/claude-logo.svg">
    Open **Settings > Connectors > Add custom connector**. Use **Notte Browser MCP** as the name and enter:

    ```text theme={null}
    https://api.notte.cc/mcp
    ```

    Connect, sign in with your Notte account, and choose the workspace Claude should use. You can use the same custom-connector flow on claude.ai.
  </Tab>

  <Tab title="Others" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/mcp-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=296ff6e096a8489747432165c72c9def" width="180" height="180" data-path="images/mcp-logo.svg">
    Add this to your MCP configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "notte": {
          "url": "https://api.notte.cc/mcp",
          "headers": {
            "Authorization": "Bearer <your-notte-api-key>"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Browser tools

The browser workflow is `manage_browsers(start)` → `browser_action(goto)` → `browser_observe` → act and observe again → `manage_browsers(stop)`.

The three page-reading tools are read-only. Management tools group inspection with state-changing actions and are marked as write tools, so your client may request confirmation even for their list or get actions.

| Tool | Permission hint | Actions or purpose |
| - | - | - |
| `manage_browsers` | Write | `start`, `list`, `status`, `stop` |
| `browser_observe` | Read | Read page state, tabs, and available element IDs |
| `browser_scrape` | Read | Extract page markdown or structured data |
| `browser_screenshot` | Read | Capture the current viewport |
| `browser_action` | Write | Navigate, click, fill forms, and interact with pages |
| `manage_files` | Write | `upload`, `list_uploads`, `get_upload`, `list_downloads`, `get_download` |
| `manage_profiles` | Write | `create`, `list`, `get`, `duplicate`, `delete` |
| `manage_auth` | Write | `list`, `get`, `check`, `reauthenticate` |

To save a login, create a profile with `manage_profiles`, then start a browser with both `profile_id` and `persist_profile=true`. Stop the browser to save its state; before reusing it, check `persisted_domains` with `manage_profiles(action="get")`.

## Verify the connection

Run this prompt in your assistant:

```text theme={null}
Use Notte Browser MCP to start a browser, navigate to https://example.com, observe the page, and extract its heading as structured JSON. Report the result and stop the browser when finished, including if any step fails.
```

## Other Notte MCP endpoints

For the broader developer API, including function and agent administration, use `https://api.notte.cc/mcp/full`. It accepts the same OAuth sign-in or Notte API key. The browser connector at `/mcp` does not expose those administration tools.

[Anything API](https://anything.notte.cc) has its own MCP endpoint at `https://anything.notte.cc/mcp` for finding, running, and building reusable APIs.

## Notte Documentation MCP

You can also configure the Notte Docs MCP to give your coding agent current documentation while it helps you build. It needs no API key.

```text theme={null}
https://docs.notte.cc/mcp
```

<Tabs>
  <Tab title="Claude Code" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/claude-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=5b5633b0bc4a9d14f2f12ed39abe527e" width="24" height="24" data-path="images/claude-logo.svg">
    Run this command and verify the connection with `claude mcp list`

    ```bash theme={null}
    claude mcp add --transport http notte-docs https://docs.notte.cc/mcp
    ```
  </Tab>

  <Tab title="Codex" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/openai-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=22739a70b7a68530abf78ef043985584" width="24" height="24" data-path="images/openai-logo.svg">
    Add this to `~/.codex/config.toml` or your project's `.codex/config.toml`

    ```toml theme={null}
    [mcp_servers.notte_docs]
    url = "https://docs.notte.cc/mcp"
    ```
  </Tab>

  <Tab title="Cursor" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/cursor-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=010084e587443335f794f13615c5191a" width="24" height="24" data-path="images/cursor-logo.svg">
    Open your MCP settings and add:

    ```json theme={null}
    {
      "mcpServers": {
        "notte-docs": {
          "url": "https://docs.notte.cc/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/claude-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=5b5633b0bc4a9d14f2f12ed39abe527e" width="24" height="24" data-path="images/claude-logo.svg">
    Add this to your Claude Desktop configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "notte-docs": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://docs.notte.cc/mcp"
          ]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Others" icon="https://mintcdn.com/notte/K1TM-nbrG7v4QOUP/images/mcp-logo.svg?fit=max&auto=format&n=K1TM-nbrG7v4QOUP&q=85&s=296ff6e096a8489747432165c72c9def" width="180" height="180" data-path="images/mcp-logo.svg">
    Add this to your MCP configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "notte-docs": {
          "url": "https://docs.notte.cc/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.