Skip to main content

Playwright browser automation tools for MCP — navigation, interaction, content extraction, and semantic locators

Project description

    # mcp-playwright-tools

    Playwright browser automation tools for MCP — navigation, interaction, content extraction, and semantic locators

    Built on [mcp-server-framework](https://pypi.org/project/mcp-server-framework/).

    ## Installation

    ```bash
    pip install mcp-playwright-tools
    ```

    ## Usage

    ```bash
    mcp-playwright-tools    # stdio (default)
    ```

    ### Claude Code / Claude Desktop

    ```json
    {
      "mcpServers": {
        "playwright": { "command": "mcp-playwright-tools" }
      }
    }
    ```

    ## Tools

    | Tool | Description |
    |------|-------------|
    | `navigate` | Navigate to a URL and wait for page load |

| current_url | Get the current page URL | | go_back | Navigate back in browser history | | go_forward | Navigate forward in browser history | | reload | Reload the current page | | get_title | Get the current page title | | get_text | Get visible text of an element | | get_all_texts | Get visible text of all matching elements | | get_page_content | Get all visible text on the page | | get_html | Get inner HTML of an element | | get_links | Get all links on the page (text + href) | | get_attribute | Get an attribute value from an element | | click | Click an element | | fill | Fill an input field with text | | type_text | Type text character by character (for autocomplete etc.) | | press | Press a keyboard key (Enter, Tab, Escape, etc.) | | select_option | Select a dropdown option by value | | select_option_by_text | Select a dropdown option by visible text | | check | Check a checkbox | | uncheck | Uncheck a checkbox | | hover | Hover over an element | | focus | Focus an element | | clear | Clear an input field | | screenshot | Take a screenshot of the page | | screenshot_element | Take a screenshot of a specific element | | wait_for | Wait for an element to appear | | wait_for_hidden | Wait for an element to disappear | | wait_for_url | Wait for the URL to match a pattern | | set_viewport | Set the browser viewport size | | scroll_to | Scroll an element into view | | scroll_page | Scroll the page up or down | | find_by_role | Find element by ARIA role (button, link, textbox, heading, etc.) | | find_by_text | Find element by visible text | | find_by_label | Find form element by its label text | | find_by_placeholder | Find input element by placeholder text | | find_by_test_id | Find element by data-testid attribute | | click_by_role | Click element found by ARIA role | | click_by_text | Click element found by visible text | | fill_by_label | Fill input found by its label text | | describe_element | Get ARIA role, text, and attributes of an element | | find_interactive_elements | List all clickable and fillable elements on the page |

    ## License

    MIT — Part of [mcp_tools](https://github.com/cuber-it/mcp_tools)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_playwright_tools-1.0.0.tar.gz (7.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_playwright_tools-1.0.0-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file mcp_playwright_tools-1.0.0.tar.gz.

File metadata

  • Download URL: mcp_playwright_tools-1.0.0.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for mcp_playwright_tools-1.0.0.tar.gz
Algorithm Hash digest
SHA256 45bedca44bbf65f85e3ed30b4c858f4ddfac43a3715eb871a5c6a32a0379bbab
MD5 1690660d50002ab7f2fca8cc8034a766
BLAKE2b-256 a4222134df5fd14a37abed7b17b69ee915710a48ac2e05291fa20074a665ef83

See more details on using hashes here.

File details

Details for the file mcp_playwright_tools-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_playwright_tools-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 df28c4b1a47f6193981bcc1e7fed1bb7f5b89a007e9ac8b85e798024243267da
MD5 d178d4b50d2ee6cdf52f37707675123c
BLAKE2b-256 9c214ec544f2094d5d61605908bf5e7e9e3ebbd5369805c72f920862b4c30cfb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page