NinjaOne MCP Server

NinjaOne MCP Server

A Model Context Protocol (MCP) server for the NinjaOne RMM platform. Gives Claude and other MCP clients direct access to your NinjaOne environment — query devices, manage alerts, run scripts, create tickets, and more.

Features

• 75 tools spanning all major NinjaOne API areas
• OAuth2 client_credentials authentication with automatic token refresh
• Pagination and device filter (df) support on all list endpoints
• Zero runtime dependencies beyond axios and the MCP SDK

Prerequisites

• Node.js 18 or later
• A NinjaOne account with API access
• OAuth2 API credentials (see Obtaining Credentials)

Obtaining Credentials

1. Log in to your NinjaOne portal and go to Administration → Apps → API
2. Click Add to create a new API application
3. Select Client Credentials as the authorization flow
4. Grant the scopes your use case requires:
   • monitoring — read-only device/alert data
   • management — manage devices, organizations, policies
   • control — run scripts, trigger patch jobs, reboot devices
5. Copy the Client ID and Client Secret — the secret is only shown once

Your instance base URL depends on your region:

Installation

Option 1 — Clone and build (recommended)

git clone https://github.com/Allied-Business-Solutions/ninjaone-mcp.git
cd ninjaone-mcp
npm install
npm run build

Option 2 — Run directly with tsx (dev/testing)

git clone https://github.com/Allied-Business-Solutions/ninjaone-mcp.git
cd ninjaone-mcp
npm install

Then use npm run dev instead of node dist/index.js in the config below.

Configuration

Environment Variables

Create a .env file by copying the example:

cp .env.example .env
# then edit .env with your credentials

Claude Desktop

Add the following to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ninjaone": {
      "command": "node",
      "args": ["/absolute/path/to/ninjaone-mcp/dist/index.js"],
      "env": {
        "NINJA_BASE_URL": "https://app.ninjarmm.com",
        "NINJA_CLIENT_ID": "your_client_id",
        "NINJA_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Restart Claude Desktop after saving.

Claude Code (CLI)

Add the server to your project or global MCP config:

claude mcp add ninjaone \
  -e NINJA_BASE_URL=https://app.ninjarmm.com \
  -e NINJA_CLIENT_ID=your_client_id \
  -e NINJA_CLIENT_SECRET=your_client_secret \
  -- node /absolute/path/to/ninjaone-mcp/dist/index.js

Other MCP Clients

The server uses stdio transport and follows the standard MCP protocol. Point any MCP-compatible client at node dist/index.js with the three environment variables set.

Available Tools

Devices (30 tools)

Organizations (10 tools)

Alerts (2 tools)

Activities (1 tool)

Ticketing (12 tools)

Queries / Reports (19 tools)

All query tools support df (device filter), pageSize, and cursor for pagination.

Policies (4 tools)

Users (7 tools)

Backup (2 tools)

System (10 tools)

Device Filter Syntax

Many tools accept a df parameter for filtering devices. Examples:

org = 1                          # Devices in organization with ID 1
status = APPROVED                # Approved devices only
class in (WINDOWS_WORKSTATION, WINDOWS_SERVER)
location = 5 AND class = MAC

Development

# Run in dev mode (no build step required)
npm run dev

# Type-check and compile
npm run build

# Start the compiled server
npm start

Project Structure

src/
  index.ts          # MCP server entry point and request routing
  client.ts         # NinjaOne HTTP client with OAuth2 token management
  utils.ts          # Shared utilities
  tools/
    types.ts        # ToolDef interface
    index.ts        # Aggregates all tool arrays
    devices.ts      # Device management tools
    organizations.ts # Organization management tools
    alerts.ts       # Alert tools
    activities.ts   # Activity log tools
    ticketing.ts    # Ticketing tools
    queries.ts      # Fleet-wide query/report tools
    policies.ts     # Policy tools
    users.ts        # User management tools
    backup.ts       # Backup tools
    system.ts       # System/admin tools

License

MIT