Browser Automation
for AI Agents

Connect Claude Code, Cursor, or any MCP client to your real Chrome tabs.
Your sessions. Your cookies. Your extensions. 19 tools. Zero headless browsers.

Get Started View on GitHub
Claude Code
> Take a screenshot and find all buttons on the page

alien_screenshot captured 1920x1080
alien_find_element selector: "button"
Found 4 elements:
[0] <button> "Sign In" (120,340 80x36)
[1] <button> "Get Started" (400,340 120x36)
[2] <button> "Learn More" (680,520 100x36)
[3] <button> "Subscribe" (400,800 140x40)

Why AlienMcp?

🌐

Your Real Browser

Not a headless instance. AI controls your actual Chrome tabs with your logged-in sessions, cookies, and extensions.

🎯

Tab Group Scoping

Choose which tabs the AI can see. Only tabs in the AlienMcp group are accessible. Full control over what's shared.

⚡

Trusted Events

Click, type, and hover via Chrome DevTools Protocol. Works on sites that reject synthetic JavaScript events.

🔌

MCP Standard

Works with any MCP client: Claude Code, Cursor, VS Code, or your own tools. One protocol, universal access.

🔒

100% Local

All communication stays on localhost. No data sent to external servers. No analytics. No tracking. Period.

🛠️

19 Tools

Screenshot, navigate, click, type, scroll, hover, wait, read DOM, execute JS, fill forms, cookies, storage, PDF, and more.

Complete Toolkit

Everything you need to automate any browser workflow.

alien_context Active tab info & group overview
alien_tabs List, create, close, activate tabs
alien_screenshot Viewport or full-page capture
alien_navigate Navigate to any URL
alien_click Click by selector or coordinates
alien_type Trusted keyboard input via CDP
alien_hover Hover for tooltips & dropdowns
alien_scroll Scroll by direction or to element
alien_wait Wait for elements to appear
alien_execute_js Run JS via CDP (bypasses CSP)
alien_read_page Read HTML, text, or selection
alien_modify_dom Edit attributes, text, styles
alien_find_element Find by selector, text, XPath, role
alien_form_input Fill forms (React/Vue compatible)
alien_network Monitor network requests
alien_console Capture console messages
alien_cookies Read, set, delete cookies
alien_storage localStorage & sessionStorage
alien_pdf Generate page PDF

How It Works

AI Agent
Claude Code, Cursor, etc.
→ stdio
MCP Server
Node.js, port 7888
→ WebSocket
Chrome Extension
Manifest V3
→ CDP
Your Browser
Real tabs, real sessions

Get Started in 2 Minutes

1

Install the Chrome Extension

git clone https://github.com/user/alien-mcp.git
cd alien-mcp/packages/chrome-extension
npm install && npm run build

Then load dist/ folder in chrome://extensions (Developer Mode)

2

Build the MCP Server

cd alien-mcp/packages/mcp-server
npm install && npm run build
3

Register with Claude Code

claude mcp add alienMcp --transport stdio -s user \
  -- node /path/to/alien-mcp/packages/mcp-server/dist/index.js
4

Add Tabs & Go

Click the 👽 extension icon, add tabs to the AlienMcp group, and start asking your AI to interact with them.