{"_id":"@autenai/mcp","_rev":"7-dcf89945a1a689541627468dabe8c2d4","name":"@autenai/mcp","dist-tags":{"latest":"0.1.5"},"versions":{"0.0.0-stage":{"name":"@autenai/mcp","version":"0.0.0-stage","_id":"@autenai/mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"dist":{"shasum":"fe9338308a520a45623b87f825a284ff66fde71a","tarball":"https://registry.npmjs.org/@autenai/mcp/-/mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-DsQW22Eta38GoMZcdQ10klDKpFpVOBqMurelIz1qFWRrALKOI3vWxzhpN6SKjEMpt8W8m8l27/NGbrl7Dy2e5w==","signatures":[{"sig":"MEUCICgW2SbvkPc6Iq9DNXH0hClckL4aixYUXJyJUuPXhgYLAiEAxV1JLoU0sSOJ6+nL1vzpWqxjaaOw3t1+g7diOjhOTn0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":334},"_npmUser":{"name":"autenai","email":"hello@auten.ai"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@autenai/mcp","version":"0.1.0","keywords":["mcp","mcp-server","model-context-protocol","computer-use","claude-code","codex","cursor","desktop-automation","ai-agent","macos","windows","linux"],"author":{"url":"https://auten.ai","name":"MB Icecode","email":"hello@auten.ai"},"license":"MIT","_id":"@autenai/mcp@0.1.0","maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"homepage":"https://auten.ai/mcp","bugs":{"url":"https://github.com/auten-ai/auten-mcp/issues","email":"hello@auten.ai"},"bin":{"auten-mcp":"bin/auten-mcp.js"},"dist":{"shasum":"9567a3bc8982f38d3f5bb9019723f485e09c76bb","tarball":"https://registry.npmjs.org/@autenai/mcp/-/mcp-0.1.0.tgz","fileCount":4,"integrity":"sha512-aj7a1CgggXV/fAY/7lDfATY5+P+iN7bIUYVCJGxs77fFwLcexE3MEVI+X8fhnQFA7CC8AsLd2pDrJOh/qWhN5w==","signatures":[{"sig":"MEQCIHAPNpThZXfSzdLkJ+X4G63j0/0uSFXj1rfziNw7UmOWAiBIL8qiPCQGsENvVd2W12nWiLWzjYN1alFOjTRkfbSu5w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQD/kVmCQgrYzMHJbR7k5uIxpzVI5xhEOhW3Qr9bda1RgwIhAJ783jLY8GoPzlUUFlxUE6ZKyKkfCiwpJJUm0m8rMtTR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14025},"type":"module","engines":{"node":">=18"},"gitHead":"b9e57dfe2dcd8b5ba4b28df1ba794428ca430329","mcpName":"io.github.auten-ai/auten-mcp","_npmUser":{"name":"autenai","email":"hello@auten.ai"},"repository":{"url":"git+https://github.com/auten-ai/auten-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"Computer use MCP server: give Claude Code, Codex, Cursor or any MCP client hands on your Mac, Windows or Linux desktop.","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1791296255011_0.9587720004621647","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@autenai/mcp","version":"0.1.1","keywords":["mcp","mcp-server","model-context-protocol","computer-use","claude-code","codex","cursor","desktop-automation","ai-agent","macos","windows","linux"],"author":{"url":"https://auten.ai","name":"MB Icecode","email":"hello@auten.ai"},"license":"MIT","_id":"@autenai/mcp@0.1.1","maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"homepage":"https://auten.ai/mcp","bugs":{"url":"https://github.com/auten-ai/auten-mcp/issues","email":"hello@auten.ai"},"bin":{"auten-mcp":"bin/auten-mcp.js"},"dist":{"shasum":"0c139f33638ef7682caeb1faba66ed492ef59b8e","tarball":"https://registry.npmjs.org/@autenai/mcp/-/mcp-0.1.1.tgz","fileCount":4,"integrity":"sha512-KttHy1yHJvHRDqlGYk0zMibJMDSOi7m9BYkBLEehz21OmSpw3MpZiS5nMdw8wd2uDDsZgXHjVuDF2/ZycNy2Rg==","signatures":[{"sig":"MEQCICeKaiC21y7l7g55YerTtIdY4s79AD88LssLl9ZZjk4VAiBHkx07Pa9uOFISzsF3JyTqnMx9t9j6S+1BhQ6H10xEgg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCiEb2JUnnH7ZJaus6uAvUY9wGtGvAG0bXUpjWY6koEYQIgFXkAgRVidt2YNy2Enz1fg3NaZrClmrFMPLblFctwJIQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14009},"type":"module","engines":{"node":">=18"},"gitHead":"560424e1862b1c682d974ce1e5f113f9e56c5d01","mcpName":"ai.auten/mcp","_npmUser":{"name":"autenai","email":"hello@auten.ai"},"repository":{"url":"git+https://github.com/auten-ai/auten-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"Computer use MCP server: give Claude Code, Codex, Cursor or any MCP client hands on your Mac, Windows or Linux desktop.","directories":{},"_nodeVersion":"25.9.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1791296595279_0.08675272442610371","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@autenai/mcp","version":"0.1.2","keywords":["mcp","mcp-server","model-context-protocol","computer-use","claude-code","codex","cursor","desktop-automation","ai-agent","macos","windows","linux","android"],"author":{"url":"https://auten.ai","name":"MB Icecode","email":"hello@auten.ai"},"license":"MIT","_id":"@autenai/mcp@0.1.2","maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"homepage":"https://auten.ai/mcp","bugs":{"url":"https://github.com/auten-ai/auten-mcp/issues","email":"hello@auten.ai"},"bin":{"auten-mcp":"bin/auten-mcp.js"},"dist":{"shasum":"f45c8d5c17dcb3d3f8c1c6f0889f2710d36d8e23","tarball":"https://registry.npmjs.org/@autenai/mcp/-/mcp-0.1.2.tgz","fileCount":4,"integrity":"sha512-AU/DB4nNyfwzDpFi2Uh8nk2HXcYZ6HAyBicg7qTl/hdq5IilHOFKd71KIylZcc/b2qvQR+gNjkr60MzmW6hRww==","signatures":[{"sig":"MEUCIQCg7A/lF6dgtTxslj1elRQbyQyPCUj07S9Ffb9D2CiMygIgfrqxcNusNiB4dzc1FstL//DlGe820S8syFWurZwmYgI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC2/tygDNPdrCD2U9mvnulhOigsUc7cfl4mUkH4Ke5FCAIhAP+anebr7bTtOH8skpsNpFFJFSYaF7jD3mB8713XGJgG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14167},"type":"module","engines":{"node":">=18"},"gitHead":"d5f001588e83d54dca689fc57fca3a237fcb7c93","mcpName":"ai.auten/mcp","_npmUser":{"name":"autenai","email":"hello@auten.ai"},"repository":{"url":"git+https://github.com/auten-ai/auten-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"Computer-use MCP server: give Claude Code, Codex, Cursor or any MCP client hands on a real screen: your computer (Mac/Windows/Linux) and your Android phone (beta). Clicks, types and reads the screen, even in apps with no API.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1791454885296_0.7617258593595779","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@autenai/mcp","version":"0.1.3","keywords":["mcp","mcp-server","model-context-protocol","computer-use","claude-code","codex","cursor","desktop-automation","ai-agent","macos","windows","linux","android"],"author":{"url":"https://auten.ai","name":"MB Icecode","email":"hello@auten.ai"},"license":"MIT","_id":"@autenai/mcp@0.1.3","maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"homepage":"https://auten.ai/mcp","bugs":{"url":"https://github.com/auten-ai/auten-mcp/issues","email":"hello@auten.ai"},"bin":{"auten-mcp":"bin/auten-mcp.js"},"dist":{"shasum":"3fa25fcea3d561c86aa869016b80930ea58080ac","tarball":"https://registry.npmjs.org/@autenai/mcp/-/mcp-0.1.3.tgz","fileCount":4,"integrity":"sha512-r45oNm5gvQesPsonO8eXuabX/aAx/iXdzpi6tBYKT+ZXEH8b/9D9c88Fq8W01KonmQqU0jEEQjn471zsKXKWyg==","signatures":[{"sig":"MEUCIGQhATHE+MHuyXKdnSzfPFz+ne6+IMnzARael/TRtHfFAiEAgoEiFtpKzyv+4JdJoha5mQj5y3/Bw7mHvoHOz3okvY4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIGgoFlXsJDQoXGTx43xOTQThHAQdVYftcMcQmaj1GxykAiApdkjRzAvk42nWcWjlUzjsRUrGK+4q0xA5XbO1E0yZQg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17012},"type":"module","engines":{"node":">=18"},"gitHead":"cbce03802f7d47caa3923ae4a32b99a884430677","mcpName":"ai.auten/mcp","_npmUser":{"name":"autenai","email":"hello@auten.ai"},"repository":{"url":"git+https://github.com/auten-ai/auten-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"Computer-use MCP server: give Claude Code, Codex, Cursor or any MCP client hands on a real screen: your computer (Mac/Windows/Linux) and your Android phone (beta). Clicks, types and reads the screen, even in apps with no API.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.3_1791617358454_0.7990478332454356","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@autenai/mcp","version":"0.1.4","keywords":["mcp","mcp-server","model-context-protocol","computer-use","claude-code","codex","cursor","desktop-automation","ai-agent","macos","windows","linux","android"],"author":{"url":"https://auten.ai","name":"MB Icecode","email":"hello@auten.ai"},"license":"MIT","_id":"@autenai/mcp@0.1.4","maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"homepage":"https://auten.ai/mcp","bugs":{"url":"https://github.com/auten-ai/auten-mcp/issues","email":"hello@auten.ai"},"bin":{"auten-mcp":"bin/auten-mcp.js"},"dist":{"shasum":"acbf4be6e880612c2cb32555f8070389449607c2","tarball":"https://registry.npmjs.org/@autenai/mcp/-/mcp-0.1.4.tgz","fileCount":4,"integrity":"sha512-LgsC+lzkj8si7i/6X7L/z9CloEApzIiV5wtG0SE8fQCTpsCMuYDqb8pZUp6WcmyrMQaLRnc646DsuNfliSDY/g==","signatures":[{"sig":"MEQCIGdmp/VtT+F9yz4+zSAsK60ssP+tiHvbpmvSzvPCqIhhAiApoPWGUFlpUaC+Hqdi7coz0F8ios/FDKxs13TEaIiNOA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIG4Cyj+hpMWJh3qhjMN0i447CDMy2vpvgjwUE/kkNVj/AiEA7ftFBPBDqRYs6Bf6Otyjc8GcM2r1rvqIl/kcd7Y90gQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":17878},"type":"module","engines":{"node":">=18"},"gitHead":"537d8e3d1df29f0edeba8fceff49865092036306","mcpName":"ai.auten/mcp","_npmUser":{"name":"autenai","email":"hello@auten.ai"},"repository":{"url":"git+https://github.com/auten-ai/auten-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"Computer-use MCP server: give Claude Code, Codex, Cursor or any MCP client hands on a real screen: your computer (Mac/Windows/Linux) and your Android phone (beta). Clicks, types and reads the screen, even in apps with no API.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.4_1791620506316_0.38410144557787085","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"_id":"@autenai/mcp@0.1.5","bin":{"auten-mcp":"bin/auten-mcp.js"},"bugs":{"url":"https://github.com/auten-ai/auten-mcp/issues","email":"hello@auten.ai"},"dist":{"shasum":"25f55c878ef5872b6dbe1c7385ba6179b84f1206","tarball":"https://registry.npmjs.org/@autenai/mcp/-/mcp-0.1.5.tgz","fileCount":4,"integrity":"sha512-sq/iWNcjwrWLSmzfE+GbB2rd3rKRKwFYB3+P1k11u8yJmMGmzsOcEeX5jb/q+oB/LGzrOCUh2ZJ2d8O74F4YvQ==","signatures":[{"sig":"MEUCIQCSxlGVnamPwHXV2lunrl+ME8NBZXwrrpGmah3veAqa3gIgMggoZjUMcgc607Kt8ORVrp2X+wXD8ARQ0QUlIKyKbaI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIB1g/anB7uvcDE8+WYFv5a2s/6cRtlKSrN/ruZ924WMIAiBD6HDr/w6oH/6/Vtm8oxIbiyR9ZTZEOxQs+7kFuvvJdA=="}],"unpackedSize":18439},"name":"@autenai/mcp","type":"module","author":{"url":"https://auten.ai","name":"MB Icecode","email":"hello@auten.ai"},"engines":{"node":">=18"},"gitHead":"6502c592c3a9c1a091af9b3312caf93bc6446740","license":"MIT","mcpName":"ai.auten/mcp","version":"0.1.5","_npmUser":{"name":"autenai","email":"hello@auten.ai"},"homepage":"https://auten.ai/mcp","keywords":["mcp","mcp-server","model-context-protocol","computer-use","claude-code","codex","cursor","desktop-automation","ai-agent","macos","windows","linux","android"],"repository":{"url":"git+https://github.com/auten-ai/auten-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"Computer-use MCP server: give Claude Code, Codex, Cursor or any MCP client hands on a real screen: your computer (Mac/Windows/Linux) and your Android phone (beta). Clicks, types and reads the screen, even in apps with no API.","directories":{},"maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.5_1792012026171_0.4919688021182047"}}},"time":{"created":"2026-10-06T14:13:25.231Z","modified":"2026-10-14T21:07:06.467Z","0.0.0-stage":"2026-10-06T14:13:25.231Z","0.1.0":"2026-10-06T14:17:35.098Z","0.1.1":"2026-10-06T14:23:15.359Z","0.1.2":"2026-10-08T10:21:25.366Z","0.1.3":"2026-10-10T07:29:18.555Z","0.1.4":"2026-10-10T08:21:46.393Z","0.1.5":"2026-10-14T21:07:06.275Z"},"bugs":{"url":"https://github.com/auten-ai/auten-mcp/issues","email":"hello@auten.ai"},"author":{"url":"https://auten.ai","name":"MB Icecode","email":"hello@auten.ai"},"license":"MIT","homepage":"https://auten.ai/mcp","keywords":["mcp","mcp-server","model-context-protocol","computer-use","claude-code","codex","cursor","desktop-automation","ai-agent","macos","windows","linux","android"],"repository":{"url":"git+https://github.com/auten-ai/auten-mcp.git","type":"git"},"description":"Computer-use MCP server: give Claude Code, Codex, Cursor or any MCP client hands on a real screen: your computer (Mac/Windows/Linux) and your Android phone (beta). Clicks, types and reads the screen, even in apps with no API.","maintainers":[{"name":"autenai","email":"hello@auten.ai"}],"readme":"<p align=\"center\">\n  <a href=\"https://auten.ai/mcp\"><img src=\"assets/banner.png\" alt=\"Auten: computer use MCP server\" width=\"720\" /></a>\n</p>\n\n<h1 align=\"center\">Auten MCP server</h1>\n\n<p align=\"center\">\n  <b>Computer use for the AI agent you already have.</b><br />\n  Claude Code, Codex, Cursor, Gemini CLI or any MCP client can click, type and read the screen\n  on your Mac, Windows or Linux computer — and your Android phone (beta) — in real apps that have no API.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@autenai/mcp\"><img src=\"https://img.shields.io/npm/v/@autenai/mcp?color=00997A&label=npm\" alt=\"npm\" /></a>\n  <a href=\"https://cursor.com/en/install-mcp?name=auten&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhdXRlbmFpL21jcCJdfQ%3D%3D\"><img src=\"https://cursor.com/deeplink/mcp-install-dark.svg\" alt=\"Add Auten to Cursor\" height=\"20\" /></a>\n  <a href=\"https://vscode.dev/redirect/mcp/install?name=auten&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40autenai%2Fmcp%22%5D%7D\"><img src=\"https://img.shields.io/badge/VS_Code-Add_Auten-0098FF?logo=visualstudiocode&logoColor=white\" alt=\"Add Auten to VS Code\" /></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://auten.ai/mcp\">Website</a> &nbsp;|&nbsp;\n  <a href=\"https://auten.ai/connect\">Setup for every client</a> &nbsp;|&nbsp;\n  <a href=\"https://auten.ai/pricing\">Pricing</a> &nbsp;|&nbsp;\n  <a href=\"mailto:hello@auten.ai\">hello@auten.ai</a>\n</p>\n\n<p align=\"center\">\n  <img src=\"assets/demo.gif\" alt=\"Animation: Claude Code asks Auten to reply on Instagram; Auten opens the app, finds the chat and sends. The next run replays the same task from memory in seconds, with no tokens.\" width=\"720\" /><br />\n  <sub>Illustration: the first run is driven by your AI, the next runs replay from memory.</sub>\n</p>\n\n---\n\nAuten is the hands, your AI is the brain. A small runner on your computer does the clicking,\ntyping and screen reading. Your agent talks to it over MCP (stdio or SSE). Auten does not ship\nits own model and never needs your AI key; your agent keeps using the plan you already pay for.\n\nWhat makes it different from a plain mouse and keyboard bridge:\n\n- **Reads the UI, not just pixels.** It uses the accessibility tree, so your agent gets a numbered\n  list of real buttons and fields (`list_elements` then `click_at(3)`) instead of guessing\n  coordinates. OCR and real screenshots are there when an app has no accessibility info.\n- **Learns a task once, replays it without AI.** After your agent finishes a task, Auten can save\n  it as a skill. The next run replays in seconds, with no tokens spent, and fixes itself when the\n  app's layout changes.\n- **Passwords stay on your machine.** `fill_login` types a stored secret into a field without the\n  agent ever seeing the value.\n\n<p align=\"center\">\n  <img src=\"assets/real-replay.gif\" alt=\"Real screen capture: an AI agent fills a local contact form through Auten MCP in about 14 seconds and saves it as a skill; run_skill then replays it with new values in 4.8 seconds without calling the model.\" width=\"640\" /><br />\n  <sub>Real capture, not an illustration: first run by the agent (~14 s incl. thinking), then <code>run_skill</code> with new values (4.8 s, no model call). Local test page, 1 fps, one cut between the runs.</sub>\n</p>\n\n## What you can ask your agent\n\nPlain requests in the client you already use. The agent decides the steps, Auten does the clicks.\n\n- \"Open the supplier portal, download this month's invoices and put them in ~/Invoices.\"\n- \"Go through the new leads in the CRM and fill in the missing company names from their emails.\"\n- \"Export the report from that desktop app as CSV. It has no API, so use the File menu.\"\n- \"On my Android phone, open Instagram and reply to the latest DM with this text.\" (phone is beta, over USB)\n- \"That worked. Save it as a skill called `export-report`.\" Next time: \"Run `export-report`.\" It replays without AI.\n\n## Quick start\n\n**1. Install the runner** (one command; no admin rights on macOS and Windows, on Linux it asks for `sudo` once to apt-install the accessibility and input tools):\n\n```bash\n# macOS and Linux\ncurl -fsSL https://auten.ai/install | bash\n```\n\n```powershell\n# Windows (PowerShell)\nirm https://auten.ai/install.ps1 | iex\n```\n\nThe first run asks you to connect a free key (30 minutes every month, no card).\n\n**2. Add Auten to your agent.** For Claude Code, Auten can do it by itself:\n\n```bash\nauten connect\n```\n\nor add it with the Claude Code CLI and check with `/mcp`:\n\n```bash\nclaude mcp add -s user auten -- auten mcp-bridge\n```\n\n**3. Ask in plain words.** For example: *\"Open Figma, export the Hero frame as PNG to my Desktop\"*\nor *\"Go through the unread invoices in my mail and fill them into the accounting app\"*.\nMore prompts for computer and phone (beta) tasks: [examples/prompts.md](examples/prompts.md).\n\n### Or run it through npx\n\nAny client that can start an npm package can use the launcher instead. It starts the installed\nrunner, and if Auten is not installed yet it tells your agent the one-line install command.\nThe \"Add to Cursor\" and \"VS Code\" buttons at the top add exactly this entry.\n\n```json\n{\n  \"mcpServers\": {\n    \"auten\": { \"command\": \"npx\", \"args\": [\"-y\", \"@autenai/mcp\"] }\n  }\n}\n```\n\n```bash\nclaude mcp add -s user auten -- npx -y @autenai/mcp\n```\n\nOn Windows, if the client reports `spawn npx ENOENT`: npx is `npx.cmd` there, and some clients start\nservers without a shell. Use `\"command\": \"cmd\", \"args\": [\"/c\", \"npx\", \"-y\", \"@autenai/mcp\"]`\n(Claude Code: `claude mcp add -s user auten -- cmd /c npx -y @autenai/mcp`), or the direct\n`auten mcp-bridge` entry below.\n\n### Or as a Claude Code plugin\n\nThis repository is also a plugin marketplace. Inside Claude Code:\n\n```\n/plugin marketplace add auten-ai/auten-mcp\n/plugin install auten@auten\n```\n\nThe plugin adds the same npx launcher entry, nothing else (no hooks or commands). See [plugin/README.md](plugin/README.md).\n\n## Client setup\n\nEvery client starts the same stdio command: `auten mcp-bridge` (or `npx -y @autenai/mcp`). If your app says it cannot find\n`auten`, use the full path from `which auten` (usually `~/.local/bin/auten`).\n\n<details>\n<summary><b>OpenAI Codex</b></summary>\n\n```bash\ncodex mcp add auten -- auten mcp-bridge\n```\n\nor in `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.auten]\ncommand = \"auten\"\nargs = [\"mcp-bridge\"]\n```\n</details>\n\n<details>\n<summary><b>Cursor</b></summary>\n\n`~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project):\n\n```json\n{\n  \"mcpServers\": {\n    \"auten\": { \"command\": \"auten\", \"args\": [\"mcp-bridge\"] }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Gemini CLI</b></summary>\n\n```bash\ngemini mcp add --scope user auten auten mcp-bridge\n```\n\nor the same `mcpServers` entry in `~/.gemini/settings.json`.\n</details>\n\n<details>\n<summary><b>Claude Desktop</b></summary>\n\nSettings, Developer, Edit Config\n(`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS,\n`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"auten\": { \"command\": \"auten\", \"args\": [\"mcp-bridge\"] }\n  }\n}\n```\n\nRestart Claude Desktop.\n</details>\n\n<details>\n<summary><b>VS Code (GitHub Copilot agent mode)</b></summary>\n\nRun `MCP: Open User Configuration` and add:\n\n```json\n{\n  \"servers\": {\n    \"auten\": { \"type\": \"stdio\", \"command\": \"auten\", \"args\": [\"mcp-bridge\"] }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Windsurf</b></summary>\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"auten\": { \"command\": \"auten\", \"args\": [\"mcp-bridge\"] }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Zed</b></summary>\n\n`~/.config/zed/settings.json`:\n\n```json\n{\n  \"context_servers\": {\n    \"auten\": { \"command\": \"auten\", \"args\": [\"mcp-bridge\"] }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Cline</b></summary>\n\nAsk Cline to set Auten up from [llms-install.md](llms-install.md), or add it yourself in\nMCP Servers, Configure (`cline_mcp_settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"auten\": { \"command\": \"auten\", \"args\": [\"mcp-bridge\"] }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Remote (SSE) instead of stdio</b></summary>\n\nFor clients that connect over the network, keep the runner online on the computer it should\ncontrol:\n\n```bash\nauten --runner-only\n```\n\nThen use your personal MCP URL from your [account page](https://auten.ai/account). It contains\nyour key, so keep it private.\n\n```bash\nclaude mcp add --transport sse auten <your-url>\n```\n</details>\n\nNo agent? Give the auten CLI your own key (Anthropic, OpenAI, Google, DeepSeek or any\nOpenAI-compatible provider) with `auten key add`, then run `auten \"open my calendar and tell me what is next\"`.\n\n## Tools\n\n| Group | Tools |\n|---|---|\n| See the screen | `list_elements`, `read_text`, `screenshot`, `screenshot_labeled`, `vision`, `screen_info` |\n| Act | `click_at`, `click`, `fill`, `type`, `paste_text`, `press_keys`, `scroll`, `drag`, `move_mouse`, `act_on_matching`, `menu_select` |\n| Apps and windows | `open_app`, `open_url`, `focus_window`, `browser_tabs`, `save_file`, `upload_file`, `clipboard_read` |\n| Secrets | `list_logins`, `fill_login`, `get_profile` |\n| Learned skills | `list_skills`, `run_skill`, `skills`, `show_skill`, `start_recording`, `stop_recording`, `start_fixing`, `stop_fixing` |\n| Coordination | `ask_user`, `focus_app`, `release`, `gui_status`, `wait`, `opened_items`, `browser_cleanup` |\n\n## Platforms\n\nmacOS (Apple Silicon and Intel), Windows 10/11, Linux (X11), plus an Android phone over USB (beta).\n\n**Linux: installer stops at the \"deps\" step?** It needs `sudo` once for the accessibility (AT-SPI) and input tools.\nOn a fresh or minimal box (empty apt lists, no `python3-venv`) install them first, then run the installer again:\n\n```bash\nsudo apt-get update\nsudo apt-get install -y python3-venv python3-pyatspi python3-gi xdotool wmctrl scrot xclip libglib2.0-bin tesseract-ocr libsecret-tools\n```\n\nAuten drives a real X11 desktop session, so a headless container without a display won't work.\nStill stuck? Paste the last lines in [Discussions](https://github.com/auten-ai/auten-mcp/discussions).\n\n## Pricing\n\n| Plan | Runtime | Price |\n|---|---|---|\n| Free | 30 min every month | €0, no card |\n| Starter | 10 h every month | €9/month (early access) |\n| Pro | Unlimited | €29/month (early access) |\n\nYou bring your own AI, so the price is for Auten only. Details on [auten.ai/pricing](https://auten.ai/pricing).\n\n## Privacy and safety\n\n- The runner only acts when your MCP client calls a tool. Nothing runs in the background on its own.\n- Stored passwords live in the system keychain (macOS, Windows) or a private local vault (Linux)\n  and never reach our servers or the model. A secret that shows up on screen is replaced with a\n  placeholder before your agent sees it.\n- Each saved login is pinned to the site or app where it was first used. On any other origin\n  `fill_login` refuses and types nothing; only you can re-pin it (`auten vault unpin <name>`).\n- Your activity history and learned skills are written to your own computer, not ours.\n  See the [privacy policy](https://auten.ai/privacy).\n\n## About this repository\n\nThis repository holds the public docs, client configs and the `@autenai/mcp` npm launcher\n(`bin/auten-mcp.js`), all under the MIT [LICENSE](LICENSE). The runner itself is distributed\nseparately through the installers above, under the [Auten terms of service](https://auten.ai/terms). Questions, bugs and feature requests are\nwelcome as [issues](https://github.com/auten-ai/auten-mcp/issues) or at hello@auten.ai.\n\nAuten is made by [MB Icecode](https://icecode.lt), Lithuania.\n","readmeFilename":"README.md"}