MCP — connect a client to omg

Use the hosted OAuth MCP for a cloud Computer, or the local MCP for sessions managed by omg serve.

omg has two MCP surfaces. They have different endpoints and different tools.

Use case	Endpoint	Result
Work on an omg cloud Computer	`https://mcp.omg.dev/mcp`	OAuth tools for shell commands, delegation, and session history
Control sessions from a local `omg serve` installation	`omg mcp` over stdio	Local session, presentation, delegation, and auto-agent tools

Hosted MCP for a cloud Computer

The canonical Streamable HTTP endpoint is:

https://mcp.omg.dev/mcp

The host also serves OAuth discovery at https://mcp.omg.dev/.well-known/oauth-protected-resource. The OAuth resource identifier is https://mcp.omg.dev. The resource identifies the service. The /mcp path identifies its Streamable HTTP endpoint.

The old origin-only endpoint remains a compatibility alias for MCP POST requests. New clients must use the canonical /mcp endpoint.

Connect from Claude Code

claude mcp add --transport http omg https://mcp.omg.dev/mcp

Then open Claude Code and ask it to call omg_status. The first tool call starts OAuth. Sign in to omg.dev, approve access, and return to the client. The client retries the call with its access token.

Hosted tools

Tool	Purpose
`omg_status`	List Computers and start a cloud Computer for a new account
`omg_bash`	Run one short shell command on a named Computer
`omg_delegate`	Start a longer coding-agent task and return its session ID
`omg_sessions`	List or search recent coding-agent sessions
`omg_session`	Read recent messages from one session

The hosted MCP does not create or steer prompt-to-app builder runs. That product and its MCP tools are retired.

Connect from ChatGPT web

ChatGPT custom MCP apps must be configured on the web. They cannot be added from a mobile conversation.

Enable developer mode for your ChatGPT account or workspace.
Open Settings → Apps → Create.
Enter https://mcp.omg.dev/mcp as the endpoint.
Select OAuth authentication.
Select Scan Tools, then complete the omg.dev sign-in and consent flow.
Create the app.
For a Workspace Agent, attach the app and allow its actions in the agent builder.

ChatGPT Agent mode does not use custom apps. The hosted omg MCP also includes shell and delegation actions, so the ChatGPT plan and workspace policy must support full MCP actions. See OpenAI's current developer mode and MCP app documentation for availability and plan restrictions.

Local MCP for omg sessions

omg mcp talks to the local omg serve API on your machine. It exposes local session tools to an MCP client. It does not use mcp.omg.dev.

Install the control plane first:

curl -fsSL https://raw.githubusercontent.com/BennyKok/omg.dev/main/scripts/setup.sh | bash

Then open http://localhost:8766. lfg is an alias for the same command.

After omg is on PATH, register the local MCP server from the UI (Settings → Coding agents → Install MCP) or with a supported agent CLI. Setup does this automatically for Claude and Codex when those CLIs are already installed.

Claude Code or CodexMCP client

stdio · omg mcp

omg MCPlocal process

http://localhost:8766

omg servelocal control plane

The local surface contains session, presentation, delegation, auto-agent, human-input, and catalog tools. Prefer its omg-managed delegation tools over a client's generic subagent helper. omg-managed child sessions remain visible in the UI and inherit the correct parent context.