# open-computer-use — Open MCP Computer Use

> open-computer-use is an open-source Computer Use service wrapped as MCP; install via npm, grant macOS permissions once, then connect any MCP client.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

1. Install + run:
   ```bash
   npm i -g open-computer-use
   open-computer-use
   ```
2. Install MCP config for your tool:
   ```bash
   open-computer-use install-claude-mcp   # writes ~/.claude.json
   open-computer-use install-codex-mcp    # writes ~/.codex/config.toml
   ```

## Intro

open-computer-use is an open-source Computer Use service wrapped as MCP; install via npm, grant macOS permissions once, then connect any MCP client.

- **Best for:** developers who want reproducible, inspectable Computer Use via a local MCP service
- **Works with:** macOS/Linux/Windows; MCP clients (Codex, Claude Code/Desktop, Gemini CLI, OpenCode); macOS needs Accessibility + Screen Recording permissions
- **Setup time:** 10–25 minutes

## Practical Notes

- Quant: the README shows one-command installers for **Codex, Claude Code, Gemini CLI, and OpenCode** MCP configs.
- Quant: it includes a `doctor` command to validate onboarding/permissions before running actions.

## Main

A safe first day:

1. Verify permissions with `open-computer-use doctor`.
2. Start with read-only tools like listing apps/windows before clicking/typing.
3. For any destructive action (send, delete, purchase), add an explicit approval gate in your agent rules.

On macOS, you must grant Accessibility + Screen Recording once; keep the service local unless you add strong access controls.

### FAQ

**Q: Does it work on Windows/Linux?**
A: Yes—README describes support for macOS, Linux, and Windows.

**Q: Why does macOS need extra setup?**
A: Accessibility and Screen Recording are required for OS-level UI automation.

**Q: How do I add it to my client?**
A: Use the built-in `install-*-mcp` commands or add an MCP server entry manually.

## Source & Thanks

> Source: https://github.com/iFurySt/open-codex-computer-use
> License: MIT
> GitHub stars: 724 · forks: 83

---

<!-- ZH -->

## 快速使用

1. 安装并运行：
   ```bash
   npm i -g open-computer-use
   open-computer-use
   ```
2. 为你的工具写入 MCP 配置：
   ```bash
   open-computer-use install-claude-mcp   # 写入 ~/.claude.json
   open-computer-use install-codex-mcp    # 写入 ~/.codex/config.toml
   ```

## 简介

open-computer-use 把开源 Computer Use 服务封装成 MCP；npm 全局安装后即可运行，macOS 只需首次授予辅助功能与录屏权限，其他 MCP 客户端可直接接入。

- **适合谁：** 希望通过本地 MCP 服务获得可复现、可检查的 Computer Use 的开发者
- **可搭配：** macOS/Linux/Windows；适配 Codex/Claude Code/Desktop/Gemini CLI/OpenCode 等 MCP 客户端；macOS 需辅助功能与录屏权限
- **准备时间：** 10–25 分钟

## 实战建议

- 量化信息：README 给出对 **Codex、Claude Code、Gemini CLI、OpenCode** 的一键 MCP 配置写入命令。
- 量化信息：内置 `doctor` 命令可在执行前检查权限与引导状态。

## 主要内容

第一天更安全的用法：

1. 先用 `open-computer-use doctor` 验证权限是否齐全。
2. 从只读能力开始（列出 apps/windows），再逐步尝试点击/输入。
3. 对外显/破坏性动作（发送、删除、购买）必须加入明确的人工审批闸门。

macOS 需要首次授予辅助功能与录屏权限；在没有强鉴权前不建议远程暴露服务。

### FAQ

**Windows/Linux 能用吗？**
答：能；README 说明支持 macOS、Linux、Windows。

**为什么 macOS 需要额外设置？**
答：系统级 UI 自动化需要辅助功能与录屏权限。

**怎么接入到我的客户端？**
答：用 `install-*-mcp` 一键写配置，或手动添加 MCP server 配置项。

## 来源与感谢

> Source: https://github.com/iFurySt/open-codex-computer-use
> License: MIT
> GitHub stars: 724 · forks: 83


---
Source: https://tokrepo.com/en/workflows/open-computer-use-open-mcp-computer-use
Author: Agent Toolkit