autologin-mcp

Getting started

This guide takes you from nothing to an agent that logs itself back in when your app shows a login form.

Requirements

1. Install

npx autologin-mcp install

This one command:

  1. registers the autologin MCP server in Claude Code at user scope, pinned to the exact version you ran;
  2. writes a skill (~/.claude/skills/autologin/SKILL.md) that tells the agent when and how to use it;
  3. adds a PreToolUse guard hook and Read/Edit deny rules that keep the credentials folder out of the model’s reach.

Add --dry-run to see the changes without applying them. CLI reference lists every change in detail.

To install from source (an unreleased version, a fork, or your own change), build a package and install from it:

git clone https://github.com/olgaysezgin/autologin-mcp.git && cd autologin-mcp
npm install && npm run build && npm pack
npx -y file:./autologin-mcp-1.0.1.tgz install --package ./autologin-mcp-1.0.1.tgz

2. Add a login profile

Run this in a normal terminal, not inside the AI chat, so the password never passes through the conversation:

npx autologin-mcp add
#   Profile name (e.g. staging): staging
#   Root URL (e.g. example.com or localhost:3000): staging.example.com
#   Username: qa@example.com
#   Password (hidden):

The profile is saved in ~/.autologin-mcp/credentials.env with file permissions 600. You can add as many profiles as you like, including several accounts for the same app (for example admin and viewer). Configuration describes the file format.

Check what the agent will see:

npx autologin-mcp list

3. Restart Claude Code and test as usual

Restart Claude Code so it starts the new MCP server. Then work as you normally would:

You:    Test the checkout flow on staging.
Agent:  …opens staging.example.com → the app redirects to /login
Agent:  calls autologin.login({ url: "https://staging.example.com/login" })
Agent:  runs the returned one-time script in the tab → { "status": "success" }
Agent:  continues the checkout test

You do not have to mention autologin-mcp in your prompt. The MCP server’s instructions and the skill tell the agent to call login whenever a page shows a login form, a “session expired” message, a 401/403 or a redirect to a login URL.

4. Optional: turn on CDP mode

By default autologin-mcp uses bridge mode, which needs no browser setup. If your app’s Content-Security-Policy blocks the bridge, or you prefer that autologin-mcp fills the tab itself, open chrome://inspect/#remote-debugging in Chrome (version 144 or newer) and turn remote debugging on. autologin-mcp then switches to CDP mode automatically. See How it works.

Update

install pins the version, so autologin-mcp never updates silently. To upgrade:

npx autologin-mcp@latest install

Uninstall

npx autologin-mcp uninstall          # keeps your credentials file
npx autologin-mcp uninstall --purge  # also deletes ~/.autologin-mcp

Next steps

Edit this page on GitHub