# blackwhite084/playwright-plus-python-mcp [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/blackwhite084/playwright-plus-python-mcp  
**GitHub Stars:** 189  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/blackwhite084-playwright-plus-python-mcp

## Description
An MCP python server using Playwright for browser automation,more suitable for llm

## Tools
Capabilities this server exposes over MCP:

- **playwright_navigate** — Navigates to a specified URL. This operation will automatically create a new session if there is no active session.
- **playwright_screenshot** — Takes a screenshot of the current page or a specific element.
- **playwright_click** — Clicks an element on the page using a CSS selector.
- **playwright_fill** — Fills out an input field.
- **playwright_evaluate** — Executes JavaScript code in the browser console.
- **playwright_click_text** — Clicks an element on the page by its text content.
- **playwright_get_text_content** — Get the text content of all visiable elements.
- **playwright_get_html_content** — Get the HTML content of the page.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "playwright-plus-python-mcp": {
    "command": "npx",
    "args": ["-y","@modelcontextprotocol/inspector"]
  }
}
```

## Documentation

## What blackwhite084/playwright-plus-python-mcp MCP server does

blackwhite084/playwright-plus-python-mcp MCP server connects MCP clients to browser automation operations built around Playwright. Its tools can open a URL, capture the current page or a selected element, click controls, populate fields, run JavaScript, and retrieve page content. Navigation creates a new session automatically when no active session exists.

The server also describes a simple note storage feature. Notes are exposed through a custom `note://` URI scheme, with each resource carrying a name, description, and `text/plain` MIME type. A `summarize-notes` prompt combines the stored notes into a summarization prompt and accepts a `style` value for brief or detailed output.

## How it works

The browser tools act on the current Playwright page. `playwright_navigate` accepts a URL and establishes a session if necessary. `playwright_screenshot` requires a file name and can optionally receive a CSS selector; without a selector, it captures the full page. `playwright_click` and `playwright_fill` use CSS selectors, while `playwright_click_text` locates an element by its text content.

For page inspection, `playwright_get_text_content` returns text from visible elements, and `playwright_get_html_content` returns HTML for a selected area using a CSS selector. `playwright_evaluate` runs supplied JavaScript in the browser console. These operations let an agent combine page navigation, interaction, and extraction in one MCP session.

## Setup and configuration

The README provides a published-server configuration for Claude Desktop using `uvx`:

```json
{
  "mcpServers": {
    "playwright-server": {
      "command": "uvx",
      "args": ["playwright-server"]
    }
  }
}
```

The configuration file is located at `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS and at `%APPDATA%/Claude/claude_desktop_config.json` on Windows. For local development, the README shows a `uv` configuration that runs the project from a specified directory. The repository does not provide completed application-specific configuration settings; its configuration section is marked as a TODO.

## Tools and capabilities

- Navigate to a specified URL.
- Capture full-page or element screenshots.
- Click elements with CSS selectors or text matching.
- Fill input fields with a supplied value.
- Execute JavaScript in the browser console.
- Read visible text and selected HTML content.
- Access stored notes through `note://` resources.
- Generate brief or detailed summaries of stored notes.

## Limitations and notes

blackwhite084/playwright-plus-python-mcp MCP server runs over stdio, so clients must launch it as a local process rather than connect to a documented hosted endpoint. The material does not specify browser installation steps, supported browser engines, persistence behavior, authentication handling, or additional environment variables. It also does not document configuration values beyond the Claude Desktop launch examples.

The screenshot tool requires a screenshot name, and page interaction tools require the selectors, text, values, scripts, or other arguments described above. The README recommends MCP Inspector for debugging stdio servers, but that utility is separate from blackwhite084/playwright-plus-python-mcp MCP server itself.

_Full upstream README: https://allmcps.com/mcp/blackwhite084-playwright-plus-python-mcp/readme_