Skip to main content
Glama
Sign In
Playwright MCP

Playwright MCP

by Patrick-Ogbue
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Playwright MCP

FastMCP server with Playwright for browser automation and web scraping. Exposes tools over HTTP for use with MCP clients (e.g. GPT-based agents).

Features

  • HTTP transport – Server runs as an HTTP service; clients connect via URL.

  • Long-lived browser – One Chromium instance started at server startup (Option A).

  • Structured logging – Structlog with configurable level and JSON output.

  • Modular layout – Config, logging, browser, tools, and server are separate; state is injected via lifespan context.

Related MCP server: mcp-browser-automation

Tools

Tool

Description

browser_navigate

Navigate to a URL

browser_snapshot

Get HTML/text snapshot of the current page

browser_tabs

List open tabs (pages)

browser_click

Click an element by CSS selector

browser_type

Type text into an element

browser_fill_form

Fill multiple form fields (selector → value map)

browser_scrape

Extract content (text, HTML, or links) from current page or URL

browser_screenshot

Take a PNG screenshot (base64) of page or element

Requirements

  • Python 3.10+

  • Playwright browsers (install after pip install)

Setup

# From project root
pip install -e .
python -m playwright install chromium

Optional: copy .env.example to .env and adjust MCP_HOST, MCP_PORT, HEADLESS, LOG_LEVEL, LOG_JSON.

Run

# After pip install -e .
playwright-mcp

# Or
python -m playwright_mcp.main

Server listens at http://127.0.0.1:8000 by default. MCP endpoint is typically at http://127.0.0.1:8000/mcp (see FastMCP HTTP deployment docs).

Project layout

src/playwright_mcp/
├── main.py           # Entrypoint
├── config/           # Env-based settings
├── logging_/          # Structlog setup and get_logger
├── browser/          # Lifecycle and BrowserState
├── tools/            # Navigation, interaction, scraping, screenshot
└── server/           # FastMCP app and dependency registration

Configuration

Env var

Default

Description

MCP_HOST

127.0.0.1

HTTP bind host

MCP_PORT

8000

HTTP bind port

HEADLESS

true

Run browser headless

LOG_LEVEL

INFO

Log level (DEBUG, INFO, WARNING, ERROR)

LOG_JSON

false

Output logs as JSON

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • playwright-mcp-server

      doucej
      A
      license
      A
      quality
      D
      maintenance
      Stateful MCP server wrapping Playwright for browser automation. Provides tools to navigate, interact, and extract data from web pages via a persistent browser session.
      19
      1,287 npm
      MIT

    • mcp-browser-automation

      ritesh-jain
      A
      license
      B
      quality
      D
      maintenance
      An MCP server for generic browser automation using Playwright. Enables MCP clients to navigate pages, inspect elements, execute JavaScript, capture screenshots, and monitor console logs and network traffic via a headless Chromium instance.
      7
      27 npm
      ISC

    • agentic-browser-mcp

      q35888
      A
      license
      A
      quality
      D
      maintenance
      Enables MCP clients to automate a real Chrome browser via Playwright, supporting session sharing and tools for navigation, clicking, typing, and more.
      11
      110 npm
      2
      MIT

    • sa2web-mcp

      sa2web
      A
      license
      C
      quality
      D
      maintenance
      Exposes a remote browser as MCP tools via Playwright, enabling AI agents to navigate and interact with web pages through DOM snapshots, clicks, typing, and form operations.
      40
      10 npm
      14
      Apache 2.0