LocalFree

Minion MCP server

apophisss/minion

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

0 GitHub stars1 forks853 npm downloads / month

Install Minion in Claude Code

PyPI (uv)

Claude Code
claude mcp add minion -- uvx minion-desktop
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "minion": {
      "command": "uvx",
      "args": [
        "minion-desktop"
      ]
    }
  }
}

npm

Claude Code
claude mcp add minion -- npx -y minion-desktop
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "minion": {
      "command": "npx",
      "args": [
        "-y",
        "minion-desktop"
      ]
    }
  }
}

MCP Bundle (.mcpb)

Claude Code
curl -LO https://github.com/Apophisss/minion/releases/download/v1.1.1/minion.mcpb
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
Download minion.mcpb and double-click it to install in Claude Desktop.

MCP Bundles install in one click in Claude Desktop. Download the file, then open it.

Frequently asked questions

What does the Minion MCP server do?

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

Is the Minion MCP server free?

Yes, most likely. Open source and no paid account or API key is mentioned in the listing. Check the provider for current pricing.

Does Minion run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Minion to Claude Code?

Run: claude mcp add minion -- uvx minion-desktop

More ai agents & coding agents MCP servers

View all