ExecuteAutomation Playwright MCP Server: Setup for Claude, Cursor and Other Apps

• Start recording actions as a test

  Starts a session that records the browser steps your assistant takes, so they can become a Playwright test file. You give it a folder to save into.

  Try: “Start recording a test into /Users/me/tests.”

  Write · start_codegen_session

• Finish recording and write the test file

  Ends a recording session and writes the generated test file into the folder you chose.

  Try: “End the recording and save the test.”

  Write · end_codegen_session

• Look at a recording session

  Returns details about one recording session by its ID.

  Try: “Show me the current recording session.”

  Read · get_codegen_session

• Throw away a recording

  Clears a recording session without writing a test.

  Try: “Discard the recording.”

  Write · clear_codegen_session

• Open a web address in the browser

  Opens a URL in a Chromium, Firefox or WebKit browser. A visible browser window opens unless you ask for headless mode.

  Try: “Open https://example.com in a browser.”

  Network · playwright_navigate

• Take a screenshot

  Takes a screenshot of the page or of one element, and can save it as a PNG file.

  Try: “Take a screenshot of the pricing table.”

  Files · playwright_screenshot

• Click an element

  Clicks an element on the page that you pick with a CSS selector.

  Try: “Click the Sign in button.”

  Write · playwright_click

• Click inside an iframe

  Clicks an element that sits inside an iframe on the page.

  Try: “Click Pay inside the payment frame.”

  Write · playwright_iframe_click

• Type into a field inside an iframe

  Types a value into an input that sits inside an iframe.

  Try: “Type the email address into the checkout frame.”

  Write · playwright_iframe_fill

• Fill in an input field

  Types a value into an input field you pick with a CSS selector.

  Try: “Fill the search box with 'running shoes'.”

  Write · playwright_fill

• Pick a dropdown option

  Chooses an option in a select dropdown.

  Try: “Select Canada in the country dropdown.”

  Write · playwright_select

• Hover over an element

  Moves the mouse over an element, for menus that open on hover.

  Try: “Hover over the Products menu.”

  Write · playwright_hover

• Upload a file to a page

  Puts a file from an absolute path on your computer into a file upload input on the page.

  Try: “Upload /Users/me/cv.pdf to the application form.”

  Files · playwright_upload_file

• Run JavaScript in the page

  Runs JavaScript code you provide inside the browser page and returns the result.

  Try: “Run JavaScript to count the links on this page.”

  Runs code · playwright_evaluate

• Read the browser console

  Returns console messages from the page, which you can filter by type such as error or warning.

  Try: “Show me the console errors.”

  Read · playwright_console_logs

• Resize the browser or emulate a device

  Changes the viewport size, or applies one of 143 device presets such as iPhone 13 or iPad Pro 11.

  Try: “Show this page as it looks on iPhone 13.”

  Write · playwright_resize

• Close the browser

  Closes the browser and releases its resources.

  Try: “Close the browser.”

  Write · playwright_close

• Send an HTTP GET request

  Sends a GET request to a URL from your computer, with optional headers and bearer token.

  Try: “GET https://api.example.com/status.”

  Network · playwright_get

• Send an HTTP POST request

  Sends a POST request with a body, optional headers and a bearer token.

  Try: “POST this JSON to https://api.example.com/items.”

  Write · playwright_post

• Send an HTTP PUT request

  Sends a PUT request with a body, which usually replaces a record on the server.

  Try: “PUT this JSON to /items/42.”

  Write · playwright_put

• Send an HTTP PATCH request

  Sends a PATCH request with a body, which usually changes part of a record.

  Try: “PATCH the name field of /items/42.”

  Write · playwright_patch

• Send an HTTP DELETE request

  Sends a DELETE request to a URL, which usually removes a record on the server.

  Try: “DELETE https://api.example.com/items/42.”

  Delete · playwright_delete

• Start waiting for a response

  Tells the browser to start waiting for a response from a URL. It returns at once and does not wait.

  Try: “Start waiting for the /api/login response.”

  Network · playwright_expect_response

• Check the response it waited for

  Waits for the response set up earlier and checks it, optionally against a value you expect.

  Try: “Check that the login response said ok.”

  Network · playwright_assert_response

• Set the browser's user agent

  Sets the user agent string the browser sends to websites.

  Try: “Use an iPhone user agent.”

  Write · playwright_custom_user_agent

• Read the visible text of the page

  Returns the text that is visible on the current page.

  Try: “Read the text on this page.”

  Read · playwright_get_visible_text

• Read the page's HTML

  Returns the HTML of the current page, with script tags removed unless you ask to keep them.

  Try: “Give me the HTML of the nav bar.”

  Read · playwright_get_visible_html

• Go back in history

  Goes back one page in the browser history.

  Try: “Go back.”

  Write · playwright_go_back

• Go forward in history

  Goes forward one page in the browser history.

  Try: “Go forward.”

  Write · playwright_go_forward

• Drag one element onto another

  Drags an element and drops it on a target element.

  Try: “Drag the card into the Done column.”

  Write · playwright_drag

• Press a keyboard key

  Presses a key such as Enter or Escape, optionally on a chosen element.

  Try: “Press Enter in the search box.”

  Write · playwright_press_key

• Save the page as a PDF

  Saves the current page as a PDF file in a folder you choose.

  Try: “Save this page as a PDF in my Downloads folder.”

  Write · playwright_save_as_pdf

• Click a link and follow it to its new tab

  Clicks a link that opens a new tab and switches the browser to that tab.

  Try: “Click the docs link and move to the new tab.”

  Write · playwright_click_and_switch_tab

Watch out for

• It runs JavaScript on any page it opens

  The evaluate tool runs code you or the assistant provide inside the browser page. Only use it on sites you trust, and never while signed in to accounts you care about. github.com

• It can send DELETE, PUT and POST requests

  The HTTP tools act with whatever token the assistant passes in. Give it test credentials, not production tokens. github.com

• It can upload local files to a website

  The upload tool takes any absolute file path on your computer and puts that file into a page's upload field. Keep sensitive files out of reach and watch which page is open. github.com

• It writes files to folders it is given

  Screenshots, PDFs and generated tests are saved to paths the assistant chooses. Check the folder before you accept. github.com

• Local HTTP mode has no sign-in

  The optional port mode is documented as localhost only. For remote use the README suggests an SSH tunnel instead of opening it up. github.com

Security advisories