Skip to content
MCP server

omp-worker-mcp

Delegate coding tasks from ChatGPT, Codex or Claude Code to local Oh My Pi workers

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.2.1
Listing updated
today

Similar MCP servers

About omp-worker-mcp

omp-worker-mcp is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The idea is a split of roles: the agent you talk to acts as supervisor, who plans, writes acceptance criteria and reviews, while the Oh My Pi (OMP) CLI on your machine does the hands-on editing, shell commands and tests with the model chosen in omp setup. The server starts OMP in the background, stores each job on disk and returns a short structured report rather than raw logs.

A single task can be delegated with omp_run_compact, or up to 50 tasks can run as a dependency graph, ten at a time, with omp_run_batch_compact. Parallel write tasks must declare the paths they own, and overlapping scopes or cycles are rejected before any worker starts. The README is clear that this is a scheduling check and not an OS-level sandbox. Workers finish with an OMP_WORKER_RESULT envelope listing status, summary, changed files and verification evidence, and omp_continue sends feedback to the same session.

It runs over stdio via npx and needs Node.js 22 or newer plus OMP installed. ChatGPT on the web reaches it through OpenAI's Secure MCP Tunnel, and OMP_WORKER_ALLOWED_ROOTS (version 0.2.0 and up) restricts where jobs may run.

Install

Run in a terminal

claude mcp add omp-worker-mcp --env OMP_WORKER_OMP_COMMAND='<OMP_WORKER_OMP_COMMAND>' -- npx -y omp-worker-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "omp-worker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "omp-worker-mcp"
      ],
      "env": {
        "OMP_WORKER_OMP_COMMAND": "<OMP_WORKER_OMP_COMMAND>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "omp-worker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "omp-worker-mcp"
      ],
      "env": {
        "OMP_WORKER_OMP_COMMAND": "<OMP_WORKER_OMP_COMMAND>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "omp-worker-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "omp-worker-mcp"
      ],
      "env": {
        "OMP_WORKER_OMP_COMMAND": "<OMP_WORKER_OMP_COMMAND>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "omp-worker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "omp-worker-mcp"
      ],
      "env": {
        "OMP_WORKER_OMP_COMMAND": "<OMP_WORKER_OMP_COMMAND>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "omp-worker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "omp-worker-mcp"
      ],
      "env": {
        "OMP_WORKER_OMP_COMMAND": "<OMP_WORKER_OMP_COMMAND>"
      }
    }
  }
}

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

Configuration

  • OMP_WORKER_OMP_COMMANDPath or executable name for the local OMP CLI binary.Required
  • OMP_WORKER_ALLOWED_ROOTSOptional JSON array of absolute directory paths that delegated job cwd values must resolve inside.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

omp_run_compact
Delegate a single task to an OMP worker.
omp_run_batch_compact
Run up to 50 tasks as a dependency graph.
omp_continue
Send feedback to the same OMP session.

What it does

Single-task delegation
omp_run_compact hands one task to a local OMP worker.
Batch dependency graph
Up to 50 tasks run as a DAG, ten at a time.
Write-scope validation
Overlapping declared write paths and cycles are rejected before work starts.
Structured results
Each job ends with status, summary, changed files and verification evidence.
Continue same session
omp_continue sends feedback to the worker that already has context.
Persistent jobs
Records, logs and results stay on disk across server restarts.
Allowed roots
OMP_WORKER_ALLOWED_ROOTS limits the directories jobs may run in.

Good for

  • Let a strong model plan while a cheaper model writes the code
  • Run a multi-module refactor in parallel without overlapping edits
  • Hand off a bug fix with tests and review the report
  • Drive work on local files from ChatGPT on the web
  • Run a long read-only investigation in the background

Pricing

Open source

Installed from npm; requires a separate Oh My Pi install

omp-worker-mcp FAQ

What do I need installed?

Node.js 22 or newer, the Oh My Pi CLI and an MCP client such as Codex, Claude Code, Cursor or ChatGPT.

Is it a sandbox?

No. It controls where jobs start and what they are told to touch, not what OMP is technically able to do.

Which model do workers use?

The default model chosen in omp setup.

How do I add it to Claude Code?

Run claude mcp add omp-worker --scope user --env OMP_WORKER_OMP_COMMAND=omp -- npx -y omp-worker-mcp.

Is omp-worker-mcp free?

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

How do I add omp-worker-mcp to Claude Code?

Run this command in your terminal: claude mcp add omp-worker-mcp --env OMP_WORKER_OMP_COMMAND='<OMP_WORKER_OMP_COMMAND>' -- npx -y omp-worker-mcp

What are the best alternatives to omp-worker-mcp?

The closest alternatives to omp-worker-mcp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers