chrome-mcpTools
Tools reference
Every tool chrome-mcp exposes over MCP, with arguments and examples. Generated from the 0.9.11 catalog.
chrome-mcp exposes 40 tools. Each one goes through the same policy gate, rate limit and never-throw error envelope. Password field values are always blanked in reads; --redact additionally scrubs secret-shaped strings.
| Tool | Group | Summary |
|---|---|---|
tabs_list | Tabs | List open browser tabs. |
tab_new | Tabs | Open a NEW tab (optionally at a URL) and focus it. |
tab_select | Tabs | Make a tab active by tabId. |
tab_close | Tabs | Close a tab by tabId. |
navigate | Navigation | Navigate a tab to a URL, REPLACING its current page. |
back | Navigation | Go back in history. |
forward | Navigation | Go forward in history. |
reload | Navigation | Reload the active (or given) tab. |
wait_for | Navigation | Wait for a selector or text to appear/disappear. |
click | Interaction | Click an element. |
type | Interaction | Type text into an element (target by selector, ref, or role+name). |
select_option | Interaction | Select option(s) of a by value or visible label. |
press | Interaction | Press a key (with optional modifiers). |
hover | Interaction | Hover over an element. |
scroll | Interaction | Scroll the page or to an element. |
fill_form | Interaction | Fill multiple fields (keyed by selector) and optionally submit. |
upload_file | Interaction | Set local file(s) on a file (target by selector or ref) — uploads without the OS dialog. |
snapshot | Reading | Accessibility snapshot: interactive elements with refs to target by ref (more reliable than guessing CSS selectors). |
get_text | Reading | Get visible text of the page or an element. |
read_as_markdown | Reading | Read the page (or subtree) as readable markdown. |
get_html | Reading | Get HTML of the page or an element. |
extract_links | Reading | Extract anchors from the page or a subtree. |
screenshot | Reading | Capture a screenshot (page or element). |
print_pdf | Reading | Render the page to PDF through Chrome's own print pipeline and save it to the task's results/ dir. |
frames_list | Reading | List the tab's frames (the top document plus every iframe the extension can reach), with each frame's id and URL. |
get_cookies | State and scripting | Read cookies visible to the tab's URL (or a given url). |
storage | State and scripting | Read/write localStorage (or sessionStorage). |
download_file | State and scripting | Download a file by URL or from a link element. |
eval | State and scripting | Evaluate JavaScript in the page (disabled in safe-mode). |
console_logs | Observers | Console output and uncaught errors recorded on the page (requires --enable-observers). |
network_log | Observers | Requests the page made - fetch and XMLHttpRequest with method, URL, status and duration (requires --enable-observers). |
dialogs | Observers | Native dialogs (alert/confirm/prompt/beforeunload) the page raised, and how they were answered (requires --enable-observers). |
chrome_status | Session and artifacts | Report backend/session status: paired browser profiles and how each was named, and flags for switched-off capabilities. |
auth_check | Session and artifacts | Is the tab sitting on a sign-in wall? Reads the page (URL, title, password fields, sign-in controls) and returns { authRequired, confidence, signals }. |
profile_use | Session and artifacts | Switch the active browser profile (identity). |
task_new | Session and artifacts | Start a new task (run) under the active profile. |
tasks_list | Session and artifacts | List every task across all profiles under the data dir, with sizes and download counts. |
task_status | Session and artifacts | Report the active profile/task and the folder paths where this run's artifacts are stored. |
batch | Batch | Run multiple tool calls in one request — parallel (default) or serial. |
profile_rename | Other | Rename an automatically named browser profile (e.g. |