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.
Links
- Source code: github.com/olgaysezgin/autologin-mcp
- Website: olgaysezgin.github.io/autologin-mcp
- Machine-readable summary for AI assistants: llms.txt and llms-full.txt
- Report a vulnerability: SECURITY.md