/ Directory / Playground / OpenAgent
● Community the-open-agent ⚡ Instant

OpenAgent

by the-open-agent · the-open-agent/openagent

Open-source personal agent with both computer-use and coding-agent modes — exposes its capabilities to Claude via MCP.

OpenAgent runs as a local assistant with two modes: computer-use (screen + input) and coding (file edits + shell). Both are exposed via MCP so Claude Code can delegate desktop or repo work to it.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "openagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "openagent-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@open-agent/mcp"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "openagent-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@open-agent/mcp"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add openagent-mcp -- npx -y @open-agent/mcp

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use OpenAgent

Delegate a fiddly desktop task to OpenAgent

👤 Developers ⏱ ~15 min intermediate

When to use: You want Claude to drive a GUI app it can't directly control.

Flow
  1. Bridge
    Run OpenAgent locally; Claude lists its tools.✓ Copied
    → Tools visible
  2. Delegate
    Ask Claude to call into OpenAgent for the GUI step.✓ Copied
    → Step runs
  3. Verify
    Inspect the run trace before accepting results.✓ Copied
    → Audit done

Outcome: Claude completes a GUI step by handing it off.

Combinations

Pair with other MCPs for X10 leverage

openagent-mcp + holaos-mcp

OpenAgent for laptop control; HolaOS for sandboxed agent desktop

Combine openagent-mcp with holaos-mcp: OpenAgent for laptop control; HolaOS for sandboxed agent desktop✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
gui_act (see docs) Run a computer-use action 1 call
code_edit (see docs) Run a coding-agent edit 1 call

Cost & Limits

What this costs to run

API quota
Local + LLM
Tokens per call
Computer-use is screenshot-heavy → expensive
Monetary
Free OSS; LLM costs
Tip
Prefer code mode when the task is text-friendly

Security

Permissions, secrets, blast radius

Minimum scopes: screen-capture input-injection
Credential storage: Local config in user dir
Data egress: Configured LLM provider
Never grant: Leave computer-use running on a machine with secrets visible

Troubleshooting

Common errors and fixes

GUI action misses target

Increase screenshot resolution or use OCR mode

Alternatives

OpenAgent vs others

AlternativeWhen to use it insteadTradeoff
UI-TARS-desktopYou want a heavier multimodal stackMore resources

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills

Continue exploring

Related tools and workflows

Choose another guide for your workflow, or explore a collection.

Explore more MCP guides

Fastly MCP

Discover Fastly API methods, inspect their documentation, and execute focused API tasks through a compact MCP tool surface.

MCP

Explore more MCP guides

Teradata MCP

Connect AI clients to Teradata for data exploration, profiling, semantic layers, analytics, and database administration.

MCP

Explore more MCP guides

Miro AI MCP

Bring Miro board context, diagrams, documents, and implementation workflows into MCP-enabled coding assistants.

MCP

Browse all topic collections → · See 29 new official additions →