Playwright Plus Python MCP

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:

{
  "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.