SpaceO MCP
SpaceO gives agents their own virtual displays on a Mac: an app, CLI and MCP server that leave your screen and cursor alone.
- 127 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent gets access to app interfaces through Accessibility and screen recording.
- The installer is downloaded from the network and runs code with user rights.
Install
- Works in
Manual install
curl -fsSL https://raw.githubusercontent.com/ParthJadhav/SpaceO/main/install.sh | bashREADME install command: downloads the signed release and verifies signature and notarization.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent gets access to app interfaces through Accessibility and screen recording.
- The installer is downloaded from the network and runs code with user rights.
This is third-party code. Review the repository files before installing.
What it does
SpaceO runs agent apps on separate virtual displays with no physical monitor. You keep working on your screen with your cursor and focus while the agent acts through accessibility actions and targeted input events. It is a native Swift app together with a CLI and an MCP server. The agent reads interface elements, clicks controls, types text, takes screenshots and checks the result. The Viewer app shows sessions, activity, pause and human handoff. Sessions can use their own display or share one in tiles. Native apps and Chromium browsers are supported.
Who it is for. Mac developers who run agents with app access and do not want them taking over the screen and cursor.
Good fit when
- An agent tests a native app while you write code.
- Several agents work with different windows on one Mac in parallel.
- You need to watch a session and step in at the right moment.
- An agent has to open a site in Chromium and walk through a scenario.
Not a fit when
- You have an Intel Mac or macOS older than 14.
- The app is built on Electron, like Cursor or VS Code, and SpaceO refuses to launch it.
- The session has to run on Windows or Linux.
Example request
Open Safari on a separate SpaceO display, find the settings page and take a screenshot.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
A Mac on Apple Silicon with macOS 14 or newer is required. The install asks for Accessibility and Screen Recording permissions, which give broad access to the interface. Electron apps such as Cursor and VS Code cannot be launched on SpaceO displays, but they can connect as MCP clients. The installer is downloaded from the network with `curl` and is worth reading before you run it, even though it checks the release signature and notarization.
How to disable. Delete the SpaceO app and the `~/.local/bin/spaceo` binary, remove the server entry from the MCP client settings and revoke the permissions in macOS system settings.
FAQ
How do I install it?
With one `curl` command from the README, which installs the signed release. Then `spaceo setup` handles permissions, a self-test and MCP configuration.
Which tools does the agent see?
Groups of `spaceo_session_*`, opening apps and windows, screen reading and screenshots, plus clicks, typing, scrolling, dragging and menus.
Can I launch Cursor on a SpaceO display?
No, such Electron apps are refused before launch. Cursor and VS Code can be used as MCP clients that drive other apps.
How do I step into the agent work?
Through the Viewer app, where you can pause a session and take over.
Which systems are supported?
Only Macs on Apple Silicon with macOS 14 and newer.
Discussion
No questions or reviews yet.
Related
MCP serversAgentOS runs a team of OpenClaw agents: workspaces, scheduled tasks, activity reports and human approvals
Local memory for Claude Code, Codex and Cursor Agent: learns from your activity on a Mac and gives agents context with source receipts over MCP
A local-first AI agent running on your own machine via llama.cpp that drives a browser, edits files, runs approved commands and remembers context across session
A Docker container bundling browser, terminal, files, VS Code and MCP services for running agent actions safely in isolation
PromptOps keeps Claude Code, Codex and Gemini CLI side by side by project and gives a lead agent MCP to launch helpers
Agent Virtual Office draws Claude Code, Codex and Gemini CLI state as a tiny browser office through hooks and HTTP
README in short
The description opens with the idea of a screen for every agent and a table of what stays with you and what the agent gets. Then come the MCP tool list, installation, permission setup and reference sections.