Connect your agent · NoMac
Meet your agent’s Mac.
A terminal or an MCP connection is all you need. Give your agent this page, or follow the steps yourself.
Add NoMac to your agent
One click adds the hosted server, which then asks you to sign in to NoMac.
Add to Claude Add to Cursor Add to VS Code Add to Replit
Claude Code
claude mcp add nomac -- npx @nomac/cli mcp
Codex
codex mcp add nomac -- npx @nomac/cli mcp
# NoMac cloud Mac setup
1. Sign in at https://nomac.app/dash and add credit: $10 to $100,
at $0.90 an hour, billed per minute ($10 = 11.1 hours). Credit
never expires. No subscription, no Apple setup required.
Agents can buy for you: nomac credits buy --packs 1 opens a payment link.
2. Terminal setup needs Node 20+ and OpenSSH, which Windows 10 and 11
include (PowerShell and cmd work). In your project directory:
npm install -g @nomac/cli
nomac login
nomac start --json
nomac sync .
nomac ssh
3. Run your own tools on the Mac. Bring your work back, then stop:
nomac pull ./build
nomac stop --json
Stopping deletes the Mac and its files, except its drive at ~/drive
(keep projects in ~/drive/src). A disconnect does not stop billing.
Queue and setup are free; ready time includes time between commands.
One-minute minimum, then billed per minute. No automatic overage.
MCP instead of a terminal:
claude mcp add nomac -- npx @nomac/cli mcp
codex mcp add nomac -- npx @nomac/cli mcp
Other stdio clients: command npx, args ["@nomac/cli", "mcp"].
Hosted MCP, no install: https://mcp.nomac.app/mcp
The Mac and the cloud iPhone (the phone tools) in one server.
App Store work (signing, TestFlight, App Store Connect) is a second
server on the same account: https://mcp.nomac.app/appstore
Everything in one: https://mcp.nomac.app/all
Shorter lists: the Mac alone (NoMac Session), https://mcp.nomac.app/session;
the cloud iPhone alone (NoMac Simulator), https://mcp.nomac.app/simulator,
or npx simulator-use cloud start from any terminal.
Sign in with your NoMac account (OAuth); nothing to paste.
ChatGPT: Settings → Apps → Advanced → Developer mode, then Create app
with that URL and OAuth authentication.
Claude: one click at https://claude.ai/directory/nomac, or
Settings → Connectors → Add custom connector, same URL.
Cursor, VS Code, Codex and other MCP clients: add it as a remote
(Streamable HTTP) server; they open the sign-in page for you.
Clients without OAuth: Authorization: Bearer <nmk_key>.
An agent in a sandbox that limits the network needs nomac.app and
*.nomac.app allowed, and *.r2.cloudflarestorage.com for upload and
download links, whose files travel there.
Use get_mac_credits, start_mac, exec_mac, get_mac_job (it returns the
output once a command ends), then stop_mac. Out of credit? get_mac_checkout returns a payment link for
the human (and opens it in their browser from the local MCP). Preserve request keys after uncertain responses.
Full instructions and current limits: https://nomac.app/llms.txt
CLI reference → API reference → An iPhone alone: NoMac Simulator →