Skip to content
MCP server

Umbriel

See and drive a whole Windows machine from Bun — apps, input, screen, OCR, registry, OS…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.14.0
Listing updated
5 days ago

About Umbriel

Umbriel is an open-source MCP server. It runs locally on your machine and is started by your AI client.

See and drive a whole Windows machine from Bun — apps, input, screen, OCR, registry, OS — via MCP.

Install

Run in a terminal

claude mcp add umbriel -- npx -y umbriel

Add to claude_desktop_config.json

{
  "mcpServers": {
    "umbriel": {
      "command": "npx",
      "args": [
        "-y",
        "umbriel"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "umbriel": {
      "command": "npx",
      "args": [
        "-y",
        "umbriel"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "umbriel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "umbriel"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "umbriel": {
      "command": "npx",
      "args": [
        "-y",
        "umbriel"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "umbriel": {
      "command": "npx",
      "args": [
        "-y",
        "umbriel"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • UMBRIEL_PROFILECapability profile: 'readonly' (inspect/read only), 'safe' (read + input + window — default), or 'full' (also os + fs tools).
  • UMBRIEL_OSSet to '1' to allow the 'os' tools (launch_app/run_program/open_path, kill_process, manage_process, control_service, set_env, registry_get/registry_list/registry_set) AND the 'fs' tools (read_file/write_file/list_dir/stat_path/make_dir/copy_file/move_file/delete_file) regardless of profile.
  • UMBRIEL_ALLOWComma-separated tool names or categories to additionally allow on top of the profile.
  • UMBRIEL_DENYComma-separated tool names or categories to deny, overriding the profile and UMBRIEL_ALLOW.
  • UMBRIEL_CURSORSet to 'never' to forbid the real-cursor fallback entirely (strictly cursor-free). By default clicks/drags are cursor-free but fall back to the real hardware cursor when no cursor-free path exists.
  • UMBRIEL_FS_ROOTSandbox root directory that the fs-category file tools (read_file/write_file/list_dir/stat_path/make_dir/copy_file/move_file/delete_file) are confined to when fs tools are enabled; open_path's path argument is honored too.
  • UMBRIEL_TRACEFile path to journal every mutating tool call as JSON Lines (tool, category, masked args, ok, observation); secret-bearing args and values are redacted. Unset = no trace.
  • UMBRIEL_FFI_TRACEFile path to a flush-before-call diagnostic journal of every COM vcall (slot, this-pointer, arg count). Each line is written and flushed to the OS BEFORE the native call, so after an uncatchable crash the last line names the faulting call. Has per-call overhead; unset = off. For debugging native faults only.
  • UMBRIEL_AUDITControls the default-on stderr audit of mutating tool calls. 'off' is the explicit opt-out (reported at startup); 'verbose' also audits reads.
  • UMBRIEL_REDACTCredential masking (default on). 'off' opts out; a regex value overrides the built-in secret shapes masked in clipboard/env/registry reads and the trace journal.

Pricing

Open source

Umbriel FAQ

Is Umbriel free?

Yes. Umbriel is open source, so you can use and self-host it for free.

How do I add Umbriel to Claude Code?

Run this command in your terminal: claude mcp add umbriel -- npx -y umbriel

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers