NinjaOne MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone git@github.com:fredriksknese/mcp-ninjaone.git
cd mcp-ninjaone
npm install
npm run build
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "NINJAONE_CLIENT_ID=${NINJAONE_CLIENT_ID}" -e "NINJAONE_CLIENT_SECRET=${NINJAONE_CLIENT_SECRET}" -e "NINJAONE_INSTANCE=${NINJAONE_INSTANCE}" ninjaone -- node "<FULL_PATH_TO_MCP_NINJAONE>/dist/index.js"

Replace <FULL_PATH_TO_MCP_NINJAONE>/dist/index.js with the actual folder you prepared in step 1.

Required:NINJAONE_CLIENT_IDNINJAONE_CLIENT_SECRETNINJAONE_INSTANCE
README.md

Connect AI assistants to the NinjaOne remote monitoring and management platform

mcp-ninjaone

A Model Context Protocol (MCP) server for NinjaOne (formerly NinjaRMM), providing AI assistants with full access to remote monitoring and management through the NinjaOne REST API v2.

Features

19 tools across five categories:

Device Management

Tool Description
list_devices List all managed devices with online status, OS, organization, and last contact
get_device Get detailed device info including hardware, agent version, and network details
get_device_activities Get recent activity log for a device (alerts, scripts, status changes)
get_device_os_patch_status View pending, installed, and failed OS patches for a device
get_device_software List all installed software on a device
get_device_processor_info Get CPU/processor details for a device
get_device_disks Get disk/storage info including capacity and free space

Organizations

Tool Description
list_organizations List all organizations (clients/customers) with ID, name, and node count
get_organization Get detailed organization info including contacts, tags, and policy assignments
list_organization_devices List all devices belonging to a specific organization
get_organization_locations Get configured locations for an organization
get_organization_policies Get policy assignments for an organization

Alerts & Conditions

Tool Description
list_alerts List active alerts across all devices, filterable by severity
list_device_alerts List all active alerts for a specific device
reset_alert Reset (acknowledge and clear) an active alert by its UID
list_alert_conditions List all configured alert trigger conditions

Maintenance Windows

Tool Description
list_maintenance_windows List all scheduled maintenance windows
create_maintenance_window Create a maintenance window for a device to suppress alerts
cancel_device_maintenance Cancel an active maintenance window to re-enable alerting

Jobs & Automation

Tool Description
list_running_jobs List currently running jobs across all devices
get_device_jobs Get all jobs (running, completed, failed) for a specific device
run_script_on_device Execute a saved script on a device

Installation

git clone git@github.com:fredriksknese/mcp-ninjaone.git
cd mcp-ninjaone
npm install
npm run build

Configuration

The server is configured via environment variables:

Variable Required Description
NINJAONE_CLIENT_ID Yes OAuth2 client ID from NinjaOne API credentials
NINJAONE_CLIENT_SECRET Yes OAuth2 client secret from NinjaOne API credentials
NINJAONE_INSTANCE Yes NinjaOne instance hostname (see table below)

Instance Hostnames

Region Hostname
US app.ninjarmm.com
EU eu.ninjarmm.com
Oceania oc.ninjarmm.com
Canada ca.ninjarmm.com

Creating API Credentials

  1. Log in to your NinjaOne instance
  2. Navigate to Administration > Apps > API
  3. Click Add to create a new API application
  4. Select Client Credentials as the authorization flow
  5. Grant the required scopes: monitoring, management, control, offline_access
  6. Copy the Client ID and Client Secret

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ninjaone": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-ninjaone/dist/index.js"],
      "env": {
        "NINJAONE_CLIENT_ID": "your-client-id",
        "NINJAONE_CLIENT_SECRET": "your-client-secret",
        "NINJAONE_INSTANCE": "app.ninjarmm.com"
      }
    }
  }
}

Usage with Claude Code

Add to your Claude Code MCP settings:

claude mcp add ninjaone -- node /absolute/path/to/mcp-ninjaone/dist/index.js

Set the required environment variables before running, or configure them in your MCP settings.

Example Prompts

Once connected, you can ask your AI assistant things like:

  • "Show me all devices that are currently offline"
  • "What active alerts do we have across all organizations?"
  • "Put device 1234 into maintenance mode for the next 2 hours"
  • "List all devices for the Acme Corp organization"
  • "What software is installed on device 5678?"
  • "Show me recent activity for device 1234"
  • "Run the cleanup script on device 9012"
  • "What jobs are currently running across all devices?"
  • "Reset all minor alerts for device 1234"
  • "What patches are pending on device 5678?"

Development

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

Architecture

src/

Tools (22)

list_devicesList all managed devices with online status, OS, organization, and last contact
get_deviceGet detailed device info including hardware, agent version, and network details
get_device_activitiesGet recent activity log for a device
get_device_os_patch_statusView pending, installed, and failed OS patches for a device
get_device_softwareList all installed software on a device
get_device_processor_infoGet CPU/processor details for a device
get_device_disksGet disk/storage info including capacity and free space
list_organizationsList all organizations with ID, name, and node count
get_organizationGet detailed organization info including contacts, tags, and policy assignments
list_organization_devicesList all devices belonging to a specific organization
get_organization_locationsGet configured locations for an organization
get_organization_policiesGet policy assignments for an organization
list_alertsList active alerts across all devices, filterable by severity
list_device_alertsList all active alerts for a specific device
reset_alertReset (acknowledge and clear) an active alert by its UID
list_alert_conditionsList all configured alert trigger conditions
list_maintenance_windowsList all scheduled maintenance windows
create_maintenance_windowCreate a maintenance window for a device to suppress alerts
cancel_device_maintenanceCancel an active maintenance window to re-enable alerting
list_running_jobsList currently running jobs across all devices
get_device_jobsGet all jobs for a specific device
run_script_on_deviceExecute a saved script on a device

Environment Variables

NINJAONE_CLIENT_IDrequiredOAuth2 client ID from NinjaOne API credentials
NINJAONE_CLIENT_SECRETrequiredOAuth2 client secret from NinjaOne API credentials
NINJAONE_INSTANCErequiredNinjaOne instance hostname

Configuration

claude_desktop_config.json
{"mcpServers": {"ninjaone": {"command": "node", "args": ["/absolute/path/to/mcp-ninjaone/dist/index.js"], "env": {"NINJAONE_CLIENT_ID": "your-client-id", "NINJAONE_CLIENT_SECRET": "your-client-secret", "NINJAONE_INSTANCE": "app.ninjarmm.com"}}}}

Try it

→Show me all devices that are currently offline
→What active alerts do we have across all organizations?
→Put device 1234 into maintenance mode for the next 2 hours
→List all devices for the Acme Corp organization
→What software is installed on device 5678?

Frequently Asked Questions

What are the key features of NinjaOne?

Full access to NinjaOne REST API v2. Comprehensive device inventory and hardware reporting. Alert management and condition monitoring. Maintenance window scheduling and suppression. Remote script execution and job tracking.

What can I use NinjaOne for?

IT administrators querying device health and patch status via natural language. Automating the suppression of alerts during scheduled maintenance windows. Quickly identifying and listing software installed across managed endpoints. Monitoring active jobs and troubleshooting failed tasks on specific devices.

How do I install NinjaOne?

Install NinjaOne by running: git clone git@github.com:fredriksknese/mcp-ninjaone.git && cd mcp-ninjaone && npm install && npm run build

What MCP clients work with NinjaOne?

NinjaOne works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep NinjaOne docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all monitoring servers →

Related MCP Servers

Skylos
Find dead code, secrets, and exploitable flows in Python, TypeScript, and Go.
monitoring344 stars
Linux MCP Server
Read-only Linux system administration and diagnostics on RHEL-based systems.
monitoring189 stars
Charles MCP Server
Integrates Charles Proxy with MCP clients for real-time network traffic analysis
monitoring118 stars
HomeButler
All-in-one homelab management MCP server.
monitoring64 stars
Wireshark MCP
Give your AI assistant a packet analyzer.
monitoring55 stars
RenderDoc MCP
Analyze GPU frame captures for graphics debugging and performance analysis.
monitoring42 stars