Skip to content
MCP server

OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved

Run recorded app workflows from your agent and check each save before moving on

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Windows, macOS
Runs
Locally
GitHub stars
3
Last commit
1 month ago
Language
Python

About OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved

OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.

OpenAdapt targets software with no usable API, such as an EMR, a payer portal or a billing system. A person or an agent demonstrates a task once; OpenAdapt compiles the demonstration into a readable workflow program, tests it in your environment and replays it with new inputs. A healthy run makes no AI model calls.

The MCP server exposes each compiled workflow to your agent as one tool call, so the agent decides what to enter and OpenAdapt does the typing. The key idea is the read-back: a run checks the right record before acting and confirms the save afterwards, and a run that cannot prove a save stops. Outcomes include VERIFIED, HALTED_BEFORE_EFFECT and RECONCILIATION_REQUIRED.

The docs report test-copy results on synthetic data: 148 of 149 claims saved correctly in openIMIS, and 62 of 63 referrals in OpenEMR. It drives web, Windows, macOS and Linux apps, and RDP or Citrix sessions. The engine is MIT licensed.

Install

Run in a terminal

claude mcp add openadapt-agent --env OPENADAPT_BUNDLE_KEY='<OPENADAPT_BUNDLE_KEY>' -- uvx openadapt-agent

Add to claude_desktop_config.json

{
  "mcpServers": {
    "openadapt-agent": {
      "command": "uvx",
      "args": [
        "openadapt-agent"
      ],
      "env": {
        "OPENADAPT_BUNDLE_KEY": "<OPENADAPT_BUNDLE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openadapt-agent": {
      "command": "uvx",
      "args": [
        "openadapt-agent"
      ],
      "env": {
        "OPENADAPT_BUNDLE_KEY": "<OPENADAPT_BUNDLE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "openadapt-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "openadapt-agent"
      ],
      "env": {
        "OPENADAPT_BUNDLE_KEY": "<OPENADAPT_BUNDLE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "openadapt-agent": {
      "command": "uvx",
      "args": [
        "openadapt-agent"
      ],
      "env": {
        "OPENADAPT_BUNDLE_KEY": "<OPENADAPT_BUNDLE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "openadapt-agent": {
      "command": "uvx",
      "args": [
        "openadapt-agent"
      ],
      "env": {
        "OPENADAPT_BUNDLE_KEY": "<OPENADAPT_BUNDLE_KEY>"
      }
    }
  }
}

Configuration

  • OPENADAPT_BUNDLE_KEYDecryption key for encrypted-at-rest bundles (workflow.json.enc). Omit for plaintext bundles.

What it does

Demonstration compiler
Turns demonstrations into a readable workflow program.
Save verification
Checks the record before and after each write.
Fail-safe stops
Halts and asks a person rather than guessing.
Desktop and remote apps
Drives web, desktop, RDP and Citrix apps.
Model-free runs
Healthy runs make no AI model calls.
Sandbox workflow
Try a no-account sandbox workflow first.

Good for

  • Enter referral data into an EMR
  • Submit claims through a portal without an API
  • Keep a record of what was saved for audit
  • Automate repetitive data entry with verification

Pricing

Open source

MIT licensed engine

Prices change. Check docs.openadapt.ai before you buy.

OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved FAQ

How do I try it?

Run `uvx --python 3.12 openadapt quickstart --break-it`, no account or API key.

What Python does it need?

3.10 to 3.12.

What happens if a check fails?

The run stops and asks a person.

What licence?

MIT.

Is OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved free?

Yes. OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved is open source, so you can use and self-host it for free.

How do I add OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved to Claude Code?

Run this command in your terminal: claude mcp add openadapt-agent --env OPENADAPT_BUNDLE_KEY='<OPENADAPT_BUNDLE_KEY>' -- uvx openadapt-agent

What are the best alternatives to OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved?

The closest alternatives to OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved are Browser Use, Scrapling MCP Server, Ha MCP, Concord MCP and Oya Browser.

Alternatives to OpenAdapt: your agent decides, OpenAdapt enters it and checks it saved

  1. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  2. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  5. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  6. Mantis

    MCP server

    Browser MCP server that gives agents numbered text pages instead of screenshots

    Runs locally
    • 1 tool
    • Open source
    • 5 Hacker News points
    • Browser automation