login-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@login-mcp open my GitHub dashboard and summarize the visible text"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
login-mcp
Local Auth MCP that reuses a human-completed browser session. Never stores passwords.
A person logs into a site once in a local Chrome window. Later, an agent calls MCP tools to open that same browser, read pages, and click or type as that user. The agent never receives the password, and this server never stores one.
Site id and human confirm / 사이트와 사람 확인
Each tool takes site (a short id such as wishket). Chrome user-data directories are separate: data/sites/<site>/profile. A login on one site is not sent to another. SSO across sites breaks on purpose.
auth_confirm is not an agent allowlist, and it is not required after the allow button. A person allows the origin within the last 10 minutes:
auth_loginopens the login URL and a local tab. Before the button, that tab lists the login origin and the work origin. Those are a registrable-site pair, or the http(s) origins of the open tabs that are not the local allow server. For Wishket that ishttps://auth.wishket.comandhttps://www.wishket.com. Click 이 사이트 허용. That records the human signal and confirms those origins for the site immediately. The success page says 허용되었습니다. Do not callauth_confirmafter the button.Or, in an interactive terminal:
node dist/index.js confirm --site wishket --origin https://auth.wishket.com --work-origin https://www.wishket.comand type the code shown only in that Chrome tab. That command only records the signal. Then callauth_confirmwithin 10 minutes.
The code and the tab URL are not returned by the MCP tool. A forged human-signal.json is ignored (HMAC, key kept in process memory). The signal expires after 10 minutes. auth_read and auth_act still refuse origins that are not confirmed.
The operator sets LOGIN_MCP_KEY in the MCP process environment (the client env block or the service environment). login-mcp does not generate, rotate, or write this key. Do not commit it. If the running server has no key, leave it unset: there is no ciphertext, and the profile stays mode 0700 (files 0600). If LOGIN_MCP_KEY is set, the per-site profile is decrypted only while that site's Chrome is running. It is encrypted again with scrypt and AES-256-GCM as soon as that site's browser closes (switching sites, the window closing, or process shutdown) and the plaintext directory is removed. If the key is unset, there is no ciphertext; the profile stays mode 0700 (files 0600) at rest, including after the browser closes. The key is never logged. SIGKILL cannot run the close hook. On the next start, and again before a site browser is opened, a plaintext leftover is encrypted immediately when the key is set, or chmod'd to 0700/0600 when it is not. That pass does not delete the session. A profile whose SingletonLock names a live process is left alone. The old shared data/chrome-profile path is not migrated, locked, or signaled, so an already-open window there is left alone.
도구마다 site가 필요합니다 (예: wishket). Chrome 프로필은 data/sites/<site>/profile 로 나뉩니다. 한 사이트 쿠키가 다른 사이트로 가지 않으며, 사이트 간 SSO는 의도적으로 깨집니다.
auth_confirm은 에이전트 허용 목록이 아니며, 허용 버튼을 누른 뒤에는 필요하지 않습니다. 최근 10분 안에 사람이 허용해야 합니다.
auth_login이 연 로컬 탭은 버튼 앞에 로그인 오리진과 작업 오리진을 보여 줍니다. 등록 가능한 사이트 쌍이거나, 로컬 허용 서버가 아닌 http(s) 탭의 오리진입니다. 위시켓은https://auth.wishket.com와https://www.wishket.com입니다. 이 사이트 허용을 누르면 신호를 기록하고 그 오리진을 바로 확인합니다. 성공 페이지는 허용되었습니다 입니다. 그 다음에auth_confirm을 호출하지 않습니다.또는 대화형 터미널에서
node dist/index.js confirm --site wishket --origin https://auth.wishket.com --work-origin https://www.wishket.com를 실행하고, Chrome 탭에만 보이는 코드를 입력합니다. 이 명령은 신호만 기록합니다. 10분 안에auth_confirm을 호출합니다.
코드와 탭 주소는 MCP 도구 결과에 나오지 않습니다. 위조한 human-signal.json은 무시됩니다. 신호는 10분 뒤 만료됩니다. 확인되지 않은 오리진은 auth_read와 auth_act가 거부합니다.
LOGIN_MCP_KEY는 운영자가 MCP 프로세스 환경에 넣습니다. 이 프로그램은 키를 만들거나 파일로 쓰지 않습니다. 커밋하지 마세요. 실행 중인 서버에 키가 없으면 그대로 둡니다. LOGIN_MCP_KEY가 있으면 그 사이트의 Chrome이 떠 있는 동안에만 프로필을 복호화합니다. 그 브라우저가 닫히면(사이트를 바꾸거나, 창을 닫거나, 프로세스가 종료되면) 바로 scrypt와 AES-256-GCM으로 다시 암호화하고 평문 디렉터리를 지웁니다. 키가 없으면 암호문은 없고, 브라우저가 닫힌 뒤에도 0700(파일 0600)만 유지합니다. 키는 로그에 남기지 않습니다. SIGKILL은 닫힘 훅을 실행할 수 없습니다. 다음 시작 때, 그리고 사이트를 열기 전에, 평문으로 남은 프로필은 키가 있으면 즉시 암호화하고 키가 없으면 0700/0600만 맞춥니다. 세션은 지우지 않습니다. SingletonLock이 살아 있는 프로세스를 가리키면 그 프로필은 그대로 둡니다. 예전 data/chrome-profile은 옮기거나 잠그거나 신호를 보내지 않습니다.
Related MCP server: Wbrowser
Security model
This server never asks for, types, or stores a password. It also never returns cookies,
localStorage,sessionStorage, or PlaywrightstorageState. It does not solve CAPTCHA, 2FA, or bot checks.The session is the per-site Chrome profile on disk. Treat it as a secret. It is gitignored. Do not copy it into a repo, a ticket, or a log.
Site ids are one path segment (
a-z,0-9,_,-). Traversal and symlink profiles are refused. The daily system Chrome profile is refused.Confirmed origins live in
data/sites/<site>/origins.json(mode0600) as a login origin plus optional work origins.auth_statusis one line per site: site id, those origins, last used time, last confirmed time, session age in milliseconds, and sessionokorneeds_login.needs_loginstays when a login page was actually seen. The age and timestamps sit next to that state so a staleokis visible. It has no cookies, tokens, or URL query secrets.Link-local addresses,
0.0.0.0/8, and cloud-metadata hosts are refused, including numeric encodings. Other hosts must be pinnable DNS names (or a literal address that is already allowed).auth_open,auth_read, andauth_actresolve those names again on every call, not only atauth_confirm. Resolution records every A and AAAA answer (and getaddrinfo, solocalhoststill works). If any answer is link-local, metadata, or unspecified, the host is refused. Chromium--host-resolver-rulesMAPaccepts only one replacement, so each DNS name is mapped to one address from that full set (lowest IPv4, else lowest IPv6; IPv6 literals are bracketed). The mapped address must be a member of the recorded set. After navigation, a connected address outside that set fails closed and the tab is blanked. If several addresses were resolved and the connected address cannot be checked, the call fails closed instead of trusting one arbitrary IP. The other checked addresses stay in the allow set; they are not discarded. A navigation restarts Chrome onto the new pin when the answers change. An in-page read or act does not continue on a stale pin: the page is closed and the profile is locked again.localhostand ordinary private addresses stay allowed for a local app. OnlyhttpandhttpsURLs are allowed.Navigation may stay on that site's confirmed login origin and work origins only. A navigation that crosses to an unconfirmed origin is not read; the tab is sent to
about:blankand the tool returnshuman_action_required. That includes a final URL on a CDN, IdP, or redirect origin that was not confirmed. Subresource requests to link-local, metadata, or unspecified hosts are blocked. Other third-party hosts are not pinned. If a confirmed site lands on a login or password page, the tool returnshuman_action_requiredand does not return page text. The message says the session expired and a human must log in again.auth_confirmstill requires the recent human allow signal.There is no stealth mode and no fingerprint evasion. Chrome runs visibly (
channel: "chrome") with the Chromium sandbox on, downloads disabled, and sync disabled.
This is for the account holder reusing their own session on their own computer. It is not a credential manager and it does not grant access the human does not already have.
Requirements
Node.js 20 or newer
Google Chrome installed locally (the
google-chromeexecutable onPATH)
Playwright drives that installed Chrome. It does not download a bundled browser.
Install
npm install
npm run build
npm testCursor MCP config
stdio transport. Point the host at the built entrypoint:
{
"mcpServers": {
"login-mcp": {
"command": "node",
"args": ["/absolute/path/to/login-mcp/dist/index.js"],
"env": {
"LOGIN_MCP_KEY": "set-a-long-secret-here"
}
}
}
}Logs go to stderr. stdout is reserved for MCP. Do not put the key on the command line. The operator sets LOGIN_MCP_KEY in that env block. If it is omitted, the server leaves the key unset and does not generate one.
Tool flow
auth_statuswith optional{ "site": "wishket" }— one line per site: site id, confirmed origins, last used time, last confirmed time, session age, and sessionokorneeds_login. No cookies, tokens, or query secrets.auth_loginwith{ "site": "wishket", "url": "https://auth.example.com/login" }— opens a visible Chrome window and returns immediately. Complete login yourself. The local tab lists the login origin and the work origin, then 이 사이트 허용. That click confirms them. The server does not type credentials. Do not callauth_confirmafter the button.auth_confirmwith{ "site": "wishket", "origin": "https://auth.example.com", "workOrigin": "https://www.example.com" }— for the terminal confirm command. Records the human-approved pair. Refuses when the human signal is missing or older than 10 minutes. Not required after 이 사이트 허용.auth_openwith{ "site": "wishket", "url": "https://www.example.com/dashboard" }— that site's profile only.auth_readwith{ "site": "wishket", "url": "...", "selector": "main" }— visible text only. Refuses origins not confirmed for that site.auth_actwith{ "site": "wishket", "action": "click", "selector": "a[href='/settings']" }— one click, fill, or key press. Password fields and challenge widgets are refused.
If a result contains "human_action_required": true, stop and use the open Chrome window. Do not retry with a guessed password.
Paths
Variable | Default |
|
|
| unset. The operator sets it in the MCP process environment. The server never generates or writes it. Unset means chmod |
Profiles are $LOGIN_MCP_DATA_DIR/sites/<site>/profile. LOGIN_MCP_USER_DATA_DIR is ignored so an older shared profile is not reused. Never point the data directory at a directory you commit, or at a Chrome profile path.
Troubleshooting
Chrome locks the user-data directory. If launch fails because Chrome is already running with this site's profile, close that window and retry. Do not delete the profile if you want to keep the session. Do not point the data directory at your normal Chrome profile or at a symlink. If a confirmed site redirects to another origin, the human must allow that origin too (the work origin field) before auth_open or auth_read can succeed.
Development
npm test
npm run build
npm startnpm start waits on stdin for an MCP client. Stop it with Ctrl+C, which closes Chrome and locks profiles. SIGKILL skips that hook. The next start seals a leftover plaintext profile (encrypt when LOGIN_MCP_KEY is set, otherwise chmod 0700/0600) without deleting the session. Do not kill or migrate a Chrome window that is already using data/chrome-profile.
Available Tools
6 toolsauth_actA
Perform one click, fill, or press on this site's current page. Re-resolves DNS on every call. Refuses unconfirmed origins, password fields, and challenge widgets. fill and press require value. Does not solve CAPTCHA or 2FA.
Inputs: site (required), action (required), selector (required), value.
auth_confirmA
Record origins for one site after a human allow signal from the last 10 minutes. The 이 사이트 허용 button already confirms origins; use this after the terminal confirm command. Refuses if that signal is missing. Optional workOrigin must be part of the same human signal. Does not read cookies.
Inputs: site (required), origin (required), workOrigin.
auth_loginB
Open a visible Chrome window for one site id so a human can log in. Also opens a local tab that lists the login origin and work origin, then the button 이 사이트 허용. That button confirms those origins. Returns immediately. Does not type credentials or return the confirmation code.
Inputs: url (required), site (required).
auth_openA
Open a URL in that site's Chrome profile. The origin must already be human-confirmed for the site (login origin or a work origin). Re-resolves every A/AAAA and pins Chrome to one address from that checked set, then fails closed if the connected address is outside the set. Returns human_action_required and no page text when the page looks like a login or challenge, or when the final origin is not a confirmed login or work origin. Blocks subresource requests to link-local or metadata hosts.
Inputs: url (required), site (required).
auth_readARead-only
Read visible text from this site's current page, or navigate first when url is set and its origin is human-confirmed for the site. Re-resolves DNS on every call. Refuses unconfirmed origins. Truncates long text. Never returns cookies or storage.
Inputs: site (required), url, selector.
auth_statusARead-only
One line per site: site id, confirmed login and work origins, last used time, last confirmed time, session age, and session ok or needs_login. needs_login means the last open saw a login page. Age makes a stale ok visible. Returns no cookies, tokens, or URL query secrets.
Inputs: site.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
auth_login (human-driven login window) and auth_open (agent-driven navigation in a confirmed profile) both open Chrome, which could cause confusion, but their descriptions clearly delineate human login vs. agent browsing. auth_read and auth_act are cleanly separated by read vs. interaction, and auth_status is distinct.
All six tools use the consistent auth_ verb_noun pattern (auth_login, auth_confirm, auth_open, auth_read, auth_act, auth_status). Names are predictable and map cleanly to actions.
Six tools is well-scoped for an authenticated-browsing server: setup (login, confirm), operations (open, read, act), and introspection (status). Each tool earns its place with no redundancy.
The surface covers the full login-to-automation lifecycle including origin confirmation and status reporting, with sensible safety boundaries. Session teardown/logout or multi-step action batching are minor gaps an agent can work around.
Related MCP Connectors
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Let your AI agent operate any website through a real, logged-in browser session.
Let AI agents use any website you're logged in to. Sessions stay encrypted on your machine.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables AI assistants and terminals to control a user's already logged-in Chrome session, allowing them to navigate pages, read content, click and type, run JavaScript, and inspect console or network activity.31MIT- AlicenseNot gradedqualityBmaintenanceEnables AI assistants and terminal users to control a logged-in Chrome browser, performing actions like opening pages, searching, filling forms, and taking screenshots without re-authentication.MIT
- AlicenseAqualityCmaintenanceEnables agents to sign into websites through a real browser without exposing passwords, keeping cookies in a local Chrome profile and providing tools for browsing and managing authenticated sessions.51MIT
- AlicenseNot gradedqualityBmaintenanceEnables controlling an existing logged-in Chrome session through MCP, including page reading, DOM interaction, tab management, and allowed file upload/download with local security boundaries.MIT