Skip to content
MCP server

NinjaOne MCP

Every NinjaOne report, plus a local store that answers fleet-wide questions no single…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.27
Listing updated
4 days ago

About NinjaOne MCP

NinjaOne MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Every NinjaOne report, plus a local store that answers fleet-wide questions no single API call can

Install

Run in a terminal

claude mcp add ninjaone-mcp --env NINJAONE_CLIENT_ID='<NINJAONE_CLIENT_ID>' --env NINJAONE_CLIENT_SECRET='<NINJAONE_CLIENT_SECRET>' --env NINJAONE_OAUTH_SCOPE='<NINJAONE_OAUTH_SCOPE>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env NINJAONE_MCP_HTTP_TOKEN='<NINJAONE_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/ninjaone-v0.1.27/ninjaone-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ninjaone-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/ninjaone-v0.1.27/ninjaone-mcp.mcpb"
      ],
      "env": {
        "NINJAONE_CLIENT_ID": "<NINJAONE_CLIENT_ID>",
        "NINJAONE_CLIENT_SECRET": "<NINJAONE_CLIENT_SECRET>",
        "NINJAONE_OAUTH_SCOPE": "<NINJAONE_OAUTH_SCOPE>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "NINJAONE_MCP_HTTP_TOKEN": "<NINJAONE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ninjaone-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/ninjaone-v0.1.27/ninjaone-mcp.mcpb"
      ],
      "env": {
        "NINJAONE_CLIENT_ID": "<NINJAONE_CLIENT_ID>",
        "NINJAONE_CLIENT_SECRET": "<NINJAONE_CLIENT_SECRET>",
        "NINJAONE_OAUTH_SCOPE": "<NINJAONE_OAUTH_SCOPE>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "NINJAONE_MCP_HTTP_TOKEN": "<NINJAONE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ninjaone-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/ninjaone-v0.1.27/ninjaone-mcp.mcpb"
      ],
      "env": {
        "NINJAONE_CLIENT_ID": "<NINJAONE_CLIENT_ID>",
        "NINJAONE_CLIENT_SECRET": "<NINJAONE_CLIENT_SECRET>",
        "NINJAONE_OAUTH_SCOPE": "<NINJAONE_OAUTH_SCOPE>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "NINJAONE_MCP_HTTP_TOKEN": "<NINJAONE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ninjaone-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/ninjaone-v0.1.27/ninjaone-mcp.mcpb"
      ],
      "env": {
        "NINJAONE_CLIENT_ID": "<NINJAONE_CLIENT_ID>",
        "NINJAONE_CLIENT_SECRET": "<NINJAONE_CLIENT_SECRET>",
        "NINJAONE_OAUTH_SCOPE": "<NINJAONE_OAUTH_SCOPE>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "NINJAONE_MCP_HTTP_TOKEN": "<NINJAONE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ninjaone-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/ninjaone-v0.1.27/ninjaone-mcp.mcpb"
      ],
      "env": {
        "NINJAONE_CLIENT_ID": "<NINJAONE_CLIENT_ID>",
        "NINJAONE_CLIENT_SECRET": "<NINJAONE_CLIENT_SECRET>",
        "NINJAONE_OAUTH_SCOPE": "<NINJAONE_OAUTH_SCOPE>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>",
        "NINJAONE_MCP_HTTP_TOKEN": "<NINJAONE_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Configuration

  • NINJAONE_BASE_URLBase URL for the NinjaOne API. Leave the prefilled default unless your account uses a different regional or self-hosted host.
  • NINJAONE_CLIENT_IDSet the NINJAONE_CLIENT_ID credential for the NinjaOne MCP server.Required
  • NINJAONE_CLIENT_SECRETSet the NINJAONE_CLIENT_SECRET credential for the NinjaOne MCP server.Required
  • NINJAONE_OAUTH_SCOPESet the NINJAONE_OAUTH_SCOPE credential for the NinjaOne MCP server.Required
  • NINJAONE_TOKEN_URLToken endpoint the client-credentials exchange posts to. Leave the prefilled default unless your tenant uses a different token endpoint.
  • NINJAONE_NO_CONFIG_WRITESet to 1 to keep credentials off disk. The token cache becomes a no-op, so the connector mints a fresh token each run instead of writing one to config.toml. Leave blank for the default cached behaviour.
  • PRINTING_PRESS_CLIENT_PROFILEOptional: binds the MCP server to an existing tenant-gated Printing Press client profile. Leave unset for a single-tenant install.
  • NINJAONE_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any state-changing execute call.
  • NINJAONE_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API and the response cache is off.
  • NINJAONE_MCP_UPLOAD_ROOTOptional. Leave unset: no NinjaOne MCP tool in this release takes a file, so this setting has no effect.
  • NINJAONE_USER_AGENTOverrides the User-Agent the CLI sends on NinjaOne requests.
  • NINJAONE_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http. Not needed for the default local stdio transport.

Pricing

Open source

NinjaOne MCP FAQ

Is NinjaOne MCP free?

Yes. NinjaOne MCP is open source, so you can use and self-host it for free.

How do I add NinjaOne MCP to Claude Code?

Run this command in your terminal: claude mcp add ninjaone-mcp --env NINJAONE_CLIENT_ID='<NINJAONE_CLIENT_ID>' --env NINJAONE_CLIENT_SECRET='<NINJAONE_CLIENT_SECRET>' --env NINJAONE_OAUTH_SCOPE='<NINJAONE_OAUTH_SCOPE>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' --env NINJAONE_MCP_HTTP_TOKEN='<NINJAONE_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/ninjaone-v0.1.27/ninjaone-mcp.mcpb