# OpenAra > Open-source Computer Use in any agent. - **Type:** MCP server - **Install:** `agentstack add mcp-aradotso-openara` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [Aradotso](https://agentstack.voostack.com/s/aradotso) - **Installs:** 0 - **Category:** [Integrations](https://agentstack.voostack.com/c/integrations) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Aradotso](https://github.com/Aradotso) - **Source:** https://github.com/Aradotso/OpenAra - **Website:** https://ara.so ## Install ```sh agentstack add mcp-aradotso-openara ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About OpenAra Open-source Computer Use, packaged as a local MCP server. --- ## Install ```bash npm i -g @openara/cli && openara ``` --- ### Add to Claude Code / Claude Desktop ```bash openara install-claude-mcp ``` Writes `mcpServers.openara` into both `~/.claude.json` (Claude Code) and `~/Library/Application Support/Claude/claude_desktop_config.json` (Claude Desktop). ### Add to Cursor ```bash openara install-cursor-mcp ``` Writes `mcpServers.openara` into `~/.cursor/mcp.json`. ### Add to Codex CLI ```bash openara install-codex-mcp ``` Writes `[mcp_servers.openara]` into `~/.codex/config.toml`. ### Add to Codex App ```bash openara install-codex-plugin ``` Installs OpenAra as a Codex plugin (manifest under `plugins/openara/`). ### Add to Gemini CLI ```bash openara install-gemini-mcp # current project (./.gemini/settings.json) openara install-gemini-mcp --scope user # global (~/.gemini/settings.json) ``` ### Add to OpenCode ```bash openara install-opencode-mcp ``` Writes `mcpServers.openara` into `~/.config/opencode/opencode.json`. --- ## What it gives you - **A local Computer Use MCP server.** Nine well-tested desktop-control tools (`list_apps`, `get_app_state`, `click`, `type_text`, `press_key`, `set_value`, `scroll`, `drag`, `perform_secondary_action`) callable from any MCP-aware client. - **Native macOS Swift** runtime — built on Accessibility + AppKit, no Electron, no Python. - **Accessibility-first execution.** Tries to drive UI through semantic AX paths before falling back to coordinate-level HID input — you keep using your computer while the agent works. - **One-line installers** for Claude Code, Claude Desktop, Cursor, Codex CLI, Codex App (plugin), Gemini CLI, and OpenCode. - **Visible cursor overlay** when the agent does need to move a pointer, so you can see what it's about to do. --- ## Manual MCP config If your agent doesn't have an installer above, or you want to see exactly what's being written, here are the raw configs. ### Claude Code Add to your project's `.claude.json` (or `~/.claude.json` for global): ```json { "mcpServers": { "openara": { "command": "openara", "args": ["mcp"] } } } ``` ### Claude Desktop Add to `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "openara": { "command": "openara", "args": ["mcp"] } } } ``` ### Cursor Add to `~/.cursor/mcp.json` (or `/.cursor/mcp.json` for project-scoped): ```json { "mcpServers": { "openara": { "command": "openara", "args": ["mcp"] } } } ``` ### Codex CLI Add to `~/.codex/config.toml`: ```toml [mcp_servers.openara] command = "openara" args = ["mcp"] ``` ### Codex App (plugin) OpenAra ships as a Codex plugin under `plugins/openara/`. From a packaged release run `openara install-codex-plugin`. From source, point Codex App's local plugin marketplace at this repo's `.agents/plugins/marketplace.json`. ### Gemini CLI Add to `./.gemini/settings.json` for the current project, or `~/.gemini/settings.json` for global use: ```json { "mcpServers": { "openara": { "command": "openara", "args": ["mcp"] } } } ``` ### OpenCode Add to `~/.config/opencode/opencode.json`: ```json { "mcpServers": { "openara": { "command": "openara", "args": ["mcp"] } } } ``` --- ## macOS permissions OpenAra needs **Accessibility** and **Screen Recording** to read window state and drive UI. The first run launches an onboarding window that takes you through granting both. To re-check at any time: ```bash openara doctor ``` --- ## CLI reference ```bash openara # first-run onboarding / no-op once granted openara mcp # stdio MCP server openara call list_apps # one tool, prints MCP-style JSON openara call get_app_state --args '{"app":"TextEdit"}' openara call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}}]' openara call --calls-file examples/textedit-overlay-seq.json --sleep 0.5 openara doctor # permissions check openara install-claude-mcp # write Claude Code + Claude Desktop config openara install-cursor-mcp # write Cursor config openara install-codex-mcp # write Codex CLI config openara install-codex-plugin # install as Codex plugin openara install-gemini-mcp [--scope user] # write Gemini CLI config openara install-opencode-mcp # write OpenCode config openara -h ``` --- ## Build from source For contributors, or while the npm package is still being prepared: ```bash git clone https://github.com/Aradotso/OpenAra.git cd OpenAra # Build everything (kit + apps + smoke suite) swift build -c release # Run the binary directly .build/release/OpenAra -h ``` You can also run through Swift Package Manager during development. Anywhere this README says `openara `, substitute `swift run OpenAra ` from inside the repo: ```bash swift run OpenAra -h swift run OpenAra mcp # start the stdio MCP server swift run OpenAra call list_apps # call a single tool swift run OpenAra doctor # check macOS permissions swift run OpenAra install-claude-mcp # write Claude Code config ``` --- ## License [MIT](./LICENSE) — forked from [iFurySt/open-codex-computer-use](https://github.com/iFurySt/open-codex-computer-use). ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [Aradotso](https://github.com/Aradotso) - **Source:** [Aradotso/OpenAra](https://github.com/Aradotso/OpenAra) - **License:** MIT - **Homepage:** https://ara.so Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-aradotso-openara - Seller: https://agentstack.voostack.com/s/aradotso - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.