mcpbeat Sign in

Minion MCP Server

by apophisss Your server? Claim it
local only

Minion runs on your own machine — the client starts it, so there is no endpoint to ping. 136 installs a week from pypi. Last commit 16 Oct 2026.

Featherweight Linux desktops for AI agents: read the screen as text, click, type, run any app.

Installs per day peak 639 · avg 21
a month agotoday
136
Installs / week
npm · minion-desktop
0
Stars
14 open issues
16 Oct 2026
Last commit
4 releases in 90 days
MIT
License
Python

What the code does

We read the source, 11 h ago · rules 995398eba69f

Evidence

Things with no honest explanation: a promise that contradicts the code, code that runs at install time while hiding what it does, data leaving the machine.

  '''cd /home/agent && runuser -u agent -- env HOME=/home/agent USER=agent LOGNAME=agent WINEDEBUG=-all WINEDLLOVERRIDES="mscoree,mshtml=;winemenubuilder.exe=d" xvfb-run -a -s "-screen 0 1280x800x24" sh -c 'wineboot --init && wine regedit /S /usr/local/share/minion/wine-agent.reg…
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

  const child = spawn(file, argv, { stdio: "inherit", windowsHide: true });
    env = dict(os.environ)

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

We found things in this code

Code changes quietly between releases, and nobody reads the diff of a dependency. We do, on every release — watch Minion and you get told the day something new turns up.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add minion -- npx -y minion-desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "minion": {
      "command": "npx",
      "args": [
        "-y",
        "minion-desktop"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.minion]
command = "npx"
args = ["-y", "minion-desktop"]
.cursor/mcp.json
{
  "mcpServers": {
    "minion": {
      "command": "npx",
      "args": [
        "-y",
        "minion-desktop"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "minion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "minion-desktop"
      ]
    }
  }
}

Alternatives to Minion

same job, measured the same way
Mandala Computer
by mandalacomputer

Cloud desktops for AI agents: create a Linux computer, see its screen, click, type and run tasks.

489 installs/wk answering
box by Simular
by simular

A cloud Linux desktop for your AI: browse, click, type, read the screen and run commands.

answering
terminal-use
by computer-agent-labs

Lets AI agents drive a real terminal: type, press keys, click, read the screen, take screenshots.

89 installs/wk local only
Buddy phone tools
by ghorbelhamdi

Android phone tools for AI agents (read the screen, tap, type, open apps), served by the Buddy app.

316 installs/wk local only
Phonebox
by phonebox

Cloud Android phones for AI agents: create a phone, read the screen, tap, type, install APKs, park.

13 tools answering
Mobilebox
by mobilebox

Cloud Android phones for AI agents: read the screen, tap, type, install APKs, park and resume.

13 tools answering
BrowserHere
by 1ts-browserhere

Control a real browser from AI agents: navigate, click, type, screenshot, read the page.

answering
PilotGentic
by pilotgentic

macOS desktop control for Claude: click, type, screenshot, AX tree, browser control, agentic loops.

44 installs/wk local only

Minion — questions

Answers built from our own checks of this server.

Why is there no uptime for Minion?
Minion runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package minion-desktop was installed 136 times last week.
How do I connect Minion?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls minion-desktop straight from npm; nothing to host, nothing to sign up for.
How many people use Minion?
The npm package minion-desktop was installed 136 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Minion open source?
Yes — it is published under the MIT licence, written in Python, 0 stars on GitHub and 14 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.