MONII MCP Server Setup for Claude Code and Cursor

Install#

npm install -g @moniiapp/cli
monii login

monii login detects Vercel and Netlify tokens already on your machine, offers to install the provider CLIs if they are missing, and writes ~/.monii/auth.json with mode 0600.

Verify:

monii whoami
monii status

Register the server#

Claude Code:

claude mcp add monii -- npx -y @moniiapp/mcp

Claude Desktop / Cursor — add to the MCP config:

{
  "mcpServers": {
    "monii": {
      "command": "npx",
      "args": ["-y", "@moniiapp/mcp"]
    }
  }
}

Restart the client. Three tools should appear:

Tool	Purpose
`monii_get_billing_status`	Spend and usage across Vercel and Netlify
`monii_read_unified_logs`	Build logs from both, normalised
`monii_trigger_kill_switch`	Pause a project

Verify it works#

> Use MONII to show my current Vercel and Netlify spend.

If it returns nothing, check monii status in a terminal first — the MCP server reads the same credential file the CLI writes, so if the CLI cannot see your projects, neither can the server.

Troubleshooting#

"No tokens found." Run monii login again. Check ~/.monii/auth.json exists and is readable by the user running the MCP client.

Tools do not appear. Restart the client fully. Most MCP clients only enumerate servers at startup.

Vercel usage is empty. Expected on the Hobby tier — Vercel's usage endpoint returns restricted data there. Deploy status and project data still work. See Vercel Hobby usage alerts.

Netlify shows nothing. Netlify tokens are account-scoped. If you have multiple accounts, re-run monii login and pick the right one.

Before you automate the kill switch

monii_trigger_kill_switch takes a real site offline. If your client supports per-tool approval, require it for that one and leave the read tools automatic.

Questions people actually ask

Is the MONII MCP server free?

Yes, and open source. Paid features are in the iOS app.

Which clients does it work with?

Anything that speaks MCP over stdio — Claude Code, Claude Desktop, Cursor, and others.

Do my tokens leave my machine?

No. They live in ~/.monii/auth.json with mode 0600 and are only ever sent to the Vercel and Netlify APIs.

The alerting lives in the app

The MCP server answers when asked. For a threshold alert that fires while you are away from the keyboard, that is the iOS app.

Get MONII for iOS ›