Handsfree

Give Claude Code access to your computer via MCP.

Handsfree is a local MCP server that lets Claude Code (or any MCP client) use your own PC: your windows, apps, keyboard and mouse, and your own browser with the sign-ins you already have. Nothing leaves your machine, there is no account, and it has zero dependencies.

Install

One command:

claude mcp add handsfree -- npx -y github:brandonmlicea/handsfree-mcp

Any other MCP client (Claude Desktop, Cursor, Codex...):

{
  "mcpServers": {
    "handsfree": { "command": "npx", "args": ["-y", "github:brandonmlicea/handsfree-mcp"] }
  }
}

Needs Node.js 22.4 or newer. The desktop tools need Windows 10 or 11; the browser tools work on Windows, macOS and Linux.

Your own browser

To let Claude work in your real browser, with your logins:

1. Open chrome://inspect/#remote-debugging (edge://inspect/#remote-debugging in Edge, brave://inspect/#remote-debugging in Brave).

2. Turn on Allow remote debugging for this browser instance.

3. The first time Claude connects, the browser asks to allow it: click Allow.

Handsfree finds the browser by itself. To use a browser started with --remote-debugging-port=9222 instead, set HANDSFREE_CDP=9222.

Related MCP server: device-controller-mcp

Tools

Claude's own desktop

On Windows, Claude's own work happens on a virtual desktop of its own, named Claude Code (you can see it in Task View, Win+Tab). Apps it launches with desk launch and pages it opens with open live there, so they never cover your windows or take your keyboard.

Claude works those windows without your mouse or keyboard: elements reads them, use presses buttons and writes text through Windows accessibility, screenshot captures them off screen, and the browser tools drive its pages through the debugging connection. When an app truly needs a real mouse, desk visit shows that desktop and desk leave hands your screen back. desk bring moves a window over when you want to see it.

It needs Windows 11 24H2 or newer. Set HANDSFREE_DESKTOP=off to keep new browser windows on your own desktop, or HANDSFREE_DESKTOP_NAME to call it something else.

How it stays out of your way

• Keys and typing go only to the window the step is working in. If another window comes to the front, it stops instead of typing into it.

• Real keys and clicks are never sent to a window on Claude's desktop, and reading or acting on one hands the focus straight back to the window you were using.

• Real keyboard and mouse steps wait until you have paused for about a second.

• Browser work happens in the background through the browser's debugging connection, so it never needs your keyboard or your screen, and new pages open in a window of their own.

• do understands what is open and installed: "the browser" is the one you have open, a misheard name ("crome") is the closest app, and it tells you when an app is not installed.

Try it

Ask Claude Code things like:

• "Put Chrome and VS Code side by side."

• "Open my Gmail and tell me the subject of the newest email."

• "Fill in the signup form on this page with my details."

• "What does the error dialog in front say?"

License

MIT