autologin-mcp

autologin-mcp documentation

autologin-mcp is an open-source Model Context Protocol (MCP) server for AI coding agents such as Claude Code. When the agent’s browser tab hits a login form or an expired session while it tests your web app, the agent calls the login tool, and autologin-mcp fills in the form with credentials stored on your machine. The username and password never appear in the conversation, so they never reach the model.

Contents

Page What it covers
Getting started Requirements, installation, your first profile, the first automatic login, uninstalling
How it works Bridge mode and CDP mode, how the login form is found and filled, how the outcome is detected
Configuration The credentials file, profile keys, URL matching, selectors, modes and environment variables
MCP tools list_profiles, login, login_status, open_config, and every result status with what the agent should do
CLI reference install, uninstall, add, list, remove, edit, and exactly what install changes
Security model What keeps the password away from the model, the threat model, and the limits
Agents and browser tools Claude Code with Claude in Chrome, Playwright MCP, chrome-devtools-mcp and other MCP clients
Troubleshooting Every common error and how to fix it
FAQ Short answers to the questions people ask most

The 30-second version

npx autologin-mcp install   # registers the MCP server, a skill and a guard hook in Claude Code
npx autologin-mcp add       # run in a normal terminal: profile name, root URL, username, hidden password

Restart Claude Code and test your app as usual. When a page asks for a login, the agent calls login, runs the one-time script it gets back in the tab, and continues with the task.

Edit this page on GitHub