Markdown Content: notte/packages/notte-mcp at main · nottelabs/notte · GitHub

===============

Skip to content Navigation Menu

Toggle navigation

Sign in

Appearance settings

• Product

*   [GitHub Copilot Write better code with AI](https://github.com/features/copilot)
*   [GitHub Spark New Build and deploy intelligent apps](https://github.com/features/spark)
*   [GitHub Models New Manage and compare prompts](https://github.com/features/models)
*   [GitHub Advanced Security Find and fix vulnerabilities](https://github.com/security/advanced-security)
*   [Actions Automate any workflow](https://github.com/features/actions)

*   [Codespaces Instant dev environments](https://github.com/features/codespaces)
*   [Issues Plan and track work](https://github.com/features/issues)
*   [Code Review Manage code changes](https://github.com/features/code-review)
*   [Discussions Collaborate outside of code](https://github.com/features/discussions)
*   [Code Search Find more, search less](https://github.com/features/code-search)

Explore * Why GitHub * All features * Documentation * GitHub Skills * Blog

• Solutions

By company size * Enterprises * Small and medium teams * Startups * Nonprofits

By use case * DevSecOps * DevOps * CI/CD * View all use cases

By industry * Healthcare * Financial services * Manufacturing * Government * View all industries

View all solutions

• Resources

Topics * AI * DevOps * Security * Software Development * View all

Explore * Learning Pathways * Events & Webinars * Ebooks & Whitepapers * Customer Stories * Partners * Executive Insights

• Open Source

*   [GitHub Sponsors Fund open source developers](https://github.com/sponsors)

*   [The ReadME Project GitHub community articles](https://github.com/readme)

Repositories * Topics * Trending * Collections

• Enterprise

*   [Enterprise platform AI-powered developer platform](https://github.com/enterprise)

Available add-ons * GitHub Advanced Security Enterprise-grade security features * Copilot for business Enterprise-grade AI features * Premium Support Enterprise-grade 24/7 support

• Pricing

Search or jump to...

Search code, repositories, users, issues, pull requests...

Search

Clear

Search syntax tips

Provide feedback

We read every piece of feedback, and take your input very seriously.

• [x] Include my email address so I can be contacted

Cancel Submit feedback

Saved searches

Use saved searches to filter your results more quickly

Name

Query

To see all available qualifiers, see our documentation.

Cancel Create saved search

Sign in

Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert

{{ message }}

nottelabs/**notte**Public

• NotificationsYou must be signed in to change notification settings

• Fork 103

• Star 1.1k

• Code

• Issues 9

• Pull requests 10

• Discussions

• Actions

• Projects 0

• Security### Uh oh! There was an error while loading.Please reload this page.

• Insights

Additional navigation options

• Code
• Issues
• Pull requests
• Discussions
• Actions
• Projects
• Security
• Insights

Collapse file tree

Files

main

Search this repository

•     .github  
  

•     .vscode  
  

•     benchmarks  
  

•     docs  
  

•     examples  
  

•     packages  
  

  •      notte-agent  
    

  •      notte-browser  
    

  •      notte-core  
    

  •      notte-eval  
    

  •      notte-integrations  
    

  •      notte-mcp  
    

    •       src/notte_mcp  
      

    •     README.md  
      

    •     claude_desktop_config.example.json  
      

    •     pyproject.toml  
      

  •      notte-sdk  
    

•     scripts  
  

•     src  
  

•     tests  
  

•   .coderabbit.yaml  
  

•   .dockerignore  
  

•   .env.example  
  

•   .gitattributes  
  

•   .gitignore  
  

•   .gitmodules  
  

•   .pre-commit-config.yaml  
  

•   .python-version  
  

•   COPYRIGHT.md  
  

•   LICENSE  
  

•   README.md  
  

•   build.sh  
  

•   makefile  
  

•   pyproject.toml  
  

•   quickstart.sh  
  

•   uv.lock  
  

Breadcrumbs

1. notte
2. /packages

/ notte-mcp

/

Copy path

Directory actions

More options

More options

Directory actions

More options

More options

Latest commit

giordano-lucas

add script error mode and selector (#476)

failure

Aug 4, 2025

cbf116d·Aug 4, 2025

History

History

Open commit details

Breadcrumbs

1. notte
2. /packages

/ notte-mcp

/

Top

Folders and files

Name	Name	Last commit message	Last commit date
### parent directory ..
src/notte_mcp	src/notte_mcp	add script error mode and selector (#476)	Aug 4, 2025
README.md	README.md	update mcp setup (#463)	Jul 26, 2025
claude_desktop_config.example.json	claude_desktop_config.example.json	update mcp setup (#463)	Jul 26, 2025
pyproject.toml	pyproject.toml	Upgrade notte version (#272)	Apr 29, 2025
View all files

README.md

Outline

⚡️ 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) 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:

undefinedshell pip install notte-mcp undefined

1. Set up your environment variables:

undefinedshell export NOTTE_API_KEY="your-api-key" undefined

1. Start the MCP server:

undefinedshell python -m notte_mcp.server undefined

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

undefinedjson { "notte-mcp": { "command": "npx", "args": [ "mcp-remote", "http://localhost:8001/sse" ], "env": { "NOTTE_API_KEY": "" } } } undefined

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:

Footer

© 2025 GitHub,Inc.

Footer navigation

• Terms
• Privacy
• Security
• Status
• Docs
• Contact
• Manage cookies
• Do not share my personal information

You can’t perform that action at this time.