# NinjaOne

Connects Claude Code to NinjaOne for devices, organizations, alerts, and tickets. Useful when an agent needs RMM data through MCP.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 26
- Author: WYRE-AI
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WYRE-AI/ninjaone-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/ninjaone

## What it does

NinjaOne gives an agent access to NinjaOne RMM data and operations. The server covers four domains: devices, organizations, alerts, and tickets. The agent chooses a domain before using its tools.

Its tool tree starts with a navigation tool, then loads the selected domain handler and NinjaOne client on demand. The Docker stdio setup needs `NINJAONE_CLIENT_ID` and `NINJAONE_CLIENT_SECRET`; `NINJAONE_REGION` selects the API region. Without the OAuth credentials, the stdio connection will not start.

HTTP deployments also require `CONDUIT_S2S_SECRET`, and `/mcp` requests need a valid gateway signature. `/health` and `/healthz` remain available as unauthenticated health checks.

## Requirements
- Needs: Docker
- Environment variables: `NINJAONE_CLIENT_ID`, `NINJAONE_CLIENT_SECRET`, `NINJAONE_REGION`, `MCP_TRANSPORT`, `AUTH_MODE`, `LOG_LEVEL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env NINJAONE_CLIENT_ID=<NINJAONE_CLIENT_ID> --env NINJAONE_CLIENT_SECRET=<NINJAONE_CLIENT_SECRET> --env NINJAONE_REGION=<NINJAONE_REGION> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env AUTH_MODE=<AUTH_MODE> --transport stdio ninjaone -- docker run -i --rm -e NINJAONE_CLIENT_ID -e NINJAONE_CLIENT_SECRET -e NINJAONE_REGION -e MCP_TRANSPORT -e AUTH_MODE ghcr.io/wyre-ai/ninjaone-mcp:v2.5.2
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add ninjaone --env NINJAONE_CLIENT_ID=<NINJAONE_CLIENT_ID> --env NINJAONE_CLIENT_SECRET=<NINJAONE_CLIENT_SECRET> --env NINJAONE_REGION=<NINJAONE_REGION> --env MCP_TRANSPORT=<MCP_TRANSPORT> --env AUTH_MODE=<AUTH_MODE> -- docker run -i --rm -e NINJAONE_CLIENT_ID -e NINJAONE_CLIENT_SECRET -e NINJAONE_REGION -e MCP_TRANSPORT -e AUTH_MODE ghcr.io/wyre-ai/ninjaone-mcp:v2.5.2
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ninjaone": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "NINJAONE_CLIENT_ID",
                "-e",
                "NINJAONE_CLIENT_SECRET",
                "-e",
                "NINJAONE_REGION",
                "-e",
                "MCP_TRANSPORT",
                "-e",
                "AUTH_MODE",
                "ghcr.io/wyre-ai/ninjaone-mcp:v2.5.2"
            ],
            "env": {
                "NINJAONE_CLIENT_ID": "<NINJAONE_CLIENT_ID>",
                "NINJAONE_CLIENT_SECRET": "<NINJAONE_CLIENT_SECRET>",
                "NINJAONE_REGION": "<NINJAONE_REGION>",
                "MCP_TRANSPORT": "<MCP_TRANSPORT>",
                "AUTH_MODE": "<AUTH_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ninjaone": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "NINJAONE_CLIENT_ID",
                "-e",
                "NINJAONE_CLIENT_SECRET",
                "-e",
                "NINJAONE_REGION",
                "-e",
                "MCP_TRANSPORT",
                "-e",
                "AUTH_MODE",
                "ghcr.io/wyre-ai/ninjaone-mcp:v2.5.2"
            ],
            "env": {
                "NINJAONE_CLIENT_ID": "<NINJAONE_CLIENT_ID>",
                "NINJAONE_CLIENT_SECRET": "<NINJAONE_CLIENT_SECRET>",
                "NINJAONE_REGION": "<NINJAONE_REGION>",
                "MCP_TRANSPORT": "<MCP_TRANSPORT>",
                "AUTH_MODE": "<AUTH_MODE>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NINJAONE_CLIENT_ID=<NINJAONE_CLIENT_ID> -e NINJAONE_CLIENT_SECRET=<NINJAONE_CLIENT_SECRET> -e NINJAONE_REGION=<NINJAONE_REGION> -e MCP_TRANSPORT=<MCP_TRANSPORT> -e AUTH_MODE=<AUTH_MODE> ninjaone docker run -i --rm -e NINJAONE_CLIENT_ID -e NINJAONE_CLIENT_SECRET -e NINJAONE_REGION -e MCP_TRANSPORT -e AUTH_MODE ghcr.io/wyre-ai/ninjaone-mcp:v2.5.2
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- inspect NinjaOne devices
- find organizations in RMM data
- review active alerts
- work through NinjaOne tickets

## Example prompts
- Check NinjaOne devices and list their current issues.
- Find the organization linked to this device and show its related records.
- Review recent alerts and tickets, then group them by domain.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md