MCP Server - Spot-Nik Docs

Connect any AI agent to your SuperPlanner workspace — Claude, Cursor, Windsurf, and more. The setup is the same regardless of which tool you use.

Prerequisites

Node.js 18 or higher
A SuperPlanner API token — generate one in SuperPlanner settings
Your monday.com region — one of us, eu, au, or il

Setup

The server runs via npx — no global install needed. Add the following block to your MCP client’s config file:

{
  "mcpServers": {
    "SuperPlanner": {
      "command": "npx",
      "args": ["-y", "@spotnik/superplanner-mcp", "--token", "sp_xxx", "--region", "us"]
    }
  }
}

Replace sp_xxx with your API token and us with your region code.

Flag	Required	Values	Description
`--token`	Yes	`sp_...`	Your SuperPlanner API token
`--region`	Yes	`us`, `eu`, `au`, `il`	The region your account is hosted in

Not sure which region to use? In monday.com, go to your avatar → Administrator → General → Profile. Your region is listed under “Your Data is stored in”. You can also start with us — the server will automatically redirect if it doesn’t match.

Config file location for common clients

Client	Config file
Claude Desktop	`claude_desktop_config.json` — find it via Claude Desktop → Settings → Developer
Cursor	`.cursor/mcp.json` in your project root, or the global Cursor MCP config
Windsurf	`~/.codeium/windsurf/mcp_config.json`

For any other MCP client, refer to its documentation on how to add a server entry using the command + args format above.