What it does
Minion provides featherweight Linux desktops for office, development, research, browser, data and Windows (Wine) work. An agent reads the screen as a list of controls with stable @ids, taken from the accessibility tree with OCR as a fallback, and can act through clicks, typing, menu commands and file dialogs. Opening an app by name installs it on first use, documents can be read and converted as text, and each action waits for the screen to settle and reports what changed, such as saved files or a blocked click.
It suits agents that need to operate desktop programs or websites, or several agents working in parallel, each on its own desktop. A person can watch a live view in the browser, take control, move files, and hand off steps such as signing in. Every action is recorded, and the session can be exported as an HTML timeline, a GIF, or a Python script that replays it without a model. The publisher describes features for reducing token use, including diffs, a compact tool-definition mode and code mode.
Running it requires Docker, OrbStack or Podman. It can be installed as a Claude Code plugin, started with uvx or npx for other MCP clients, or set up with a single installer line that connects supported AI apps. For ChatGPT, Claude.ai or Le Chat, the publisher says to run minion share and paste the printed URL into the app's connector settings. Each desktop is a small container that is ready in about 1.5 seconds and is frozen when idle.
Limitations and requirements
Requires Docker, OrbStack or Podman. Browser-based apps (ChatGPT, Claude.ai, Le Chat) need the URL printed by minion share to be pasted into their connector settings. Windows programs run only through the windows (Wine) profile.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
Minion
Featherweight Linux desktops for AI agents: read the screen as text, click, type, run any app.
v1.1.1As shown on registry.modelcontextprotocol.io when we last read it