Skip to main content
Glama

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

Related MCP server: action1-mcp

Prerequisites

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:

Region

Base URL

US

https://app.ninjarmm.com

EU

https://eu.ninjarmm.com

OC

https://oc.ninjarmm.com

CA

https://ca.ninjarmm.com

Installation

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

Variable

Required

Description

NINJA_BASE_URL

Yes

NinjaOne instance URL (e.g. https://app.ninjarmm.com)

NINJA_CLIENT_ID

Yes

OAuth2 client ID from the NinjaOne Developer Portal

NINJA_CLIENT_SECRET

Yes

OAuth2 client secret from the NinjaOne Developer Portal

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)

Tool

Description

ninja_list_devices

List all managed devices with optional device filter (df) and pagination

ninja_get_device

Get full details for a single device by ID

ninja_get_devices_detailed

List devices with detailed settings and policy assignments

ninja_search_devices

Search devices by name, hostname, or serial number

ninja_update_device

Update device display name, location, role, or policy

ninja_get_device_activities

Get the activity log for a device

ninja_get_device_alerts

Get active alerts on a device

ninja_get_device_software

List installed software on a device

ninja_get_device_os_patches

Get pending/failed/rejected OS patches

ninja_get_device_installed_os_patches

Get OS patch install history

ninja_get_device_software_patches

Get pending/failed/rejected software patches

ninja_get_device_installed_software_patches

Get software patch install history

ninja_get_device_volumes

Get disk volume info (capacity, free space, filesystem)

ninja_get_device_disks

Get physical disk drive info

ninja_get_device_network_interfaces

Get network adapters, IPs, and MAC addresses

ninja_get_device_processors

Get CPU/processor details

ninja_get_device_windows_services

Get Windows service status

ninja_get_device_last_logged_on_user

Get the last user who logged on

ninja_get_device_active_jobs

Get currently running jobs on a device

ninja_get_device_dashboard_url

Get the direct URL to a device in the NinjaOne dashboard

ninja_get_device_scripting_options

List scripts and actions available for a device

ninja_get_device_custom_fields

Get custom field values for a device

ninja_update_device_custom_fields

Update custom field values on a device

ninja_reboot_device

Reboot a device (NORMAL or FORCED mode)

ninja_run_script

Run a custom script or built-in action on a device

ninja_submit_os_patch_scan

Trigger an OS patch scan

ninja_submit_os_patch_apply

Apply OS patches

ninja_submit_software_patch_scan

Trigger a software patch scan

ninja_submit_software_patch_apply

Apply software patches

ninja_approve_devices

Approve or reject pending device registrations

Organizations (10 tools)

Tool

Description

ninja_list_organizations

List all organizations (clients) with pagination

ninja_get_organizations_detailed

List organizations with full settings and policy mappings

ninja_get_organization

Get details for a specific organization

ninja_create_organization

Create a new organization

ninja_update_organization

Update an organization's name, description, or approval mode

ninja_get_organization_devices

List all devices in an organization

ninja_get_organization_locations

List all locations for an organization

ninja_create_organization_location

Create a new location for an organization

ninja_get_organization_custom_fields

Get custom field values for an organization

ninja_get_organization_end_users

Get end users associated with an organization

Alerts (2 tools)

Tool

Description

ninja_list_alerts

Get all active alerts across all devices

ninja_reset_alert

Dismiss/reset an alert by UID, optionally adding a resolution note

Activities (1 tool)

Tool

Description

ninja_list_activities

Query the system activity log with filters for class, date range, type, user, and device

Ticketing (12 tools)

Tool

Description

ninja_create_ticket

Create a new support ticket

ninja_get_ticket

Get a ticket by ID

ninja_update_ticket

Update ticket status, assignee, severity, priority, or tags

ninja_add_ticket_comment

Add a public or private comment to a ticket

ninja_get_ticket_log

Get the change log for a ticket

ninja_get_tickets_by_board

Query tickets on a specific board

ninja_list_boards

List all ticketing boards

ninja_list_ticket_statuses

List all available ticket statuses

ninja_list_ticket_forms

List all ticket forms

ninja_get_ticket_form

Get details and fields for a specific ticket form

ninja_list_ticketing_users

List app users and contacts available in ticketing

ninja_get_ticket_attributes

Get custom attribute definitions for tickets

Queries / Reports (19 tools)

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

Tool

Description

ninja_query_antivirus_status

AV product status across all devices

ninja_query_antivirus_threats

AV threats detected across all devices

ninja_query_device_health

Device health report (online/offline, alerts, patch compliance)

ninja_query_os_patches

Pending/failed/rejected OS patches fleet-wide

ninja_query_software_patches

Pending/failed/rejected software patches fleet-wide

ninja_query_installed_os_patches

OS patch install history fleet-wide

ninja_query_installed_software_patches

Software patch install history fleet-wide

ninja_query_software

Software inventory fleet-wide

ninja_query_logged_on_users

Last logged-on user fleet-wide

ninja_query_computer_systems

Hardware info (make, model, serial) fleet-wide

ninja_query_operating_systems

OS name, version, and build fleet-wide

ninja_query_network_interfaces

Network interface info fleet-wide

ninja_query_disks

Physical disk info fleet-wide

ninja_query_volumes

Disk volume info fleet-wide

ninja_query_windows_services

Windows service status fleet-wide

ninja_query_custom_fields

Custom field values fleet-wide

ninja_query_processors

CPU info fleet-wide

ninja_query_backup_usage

Backup storage usage fleet-wide

ninja_query_policy_overrides

Policy overrides fleet-wide

Policies (4 tools)

Tool

Description

ninja_list_policies

List all policies

ninja_get_device_policy_overrides

Get policy overrides for a specific device

ninja_query_policy_overrides

Query policy overrides across all devices

ninja_list_node_roles

List all available device/node roles

Users (7 tools)

Tool

Description

ninja_list_users

List all users (technicians and end users)

ninja_list_technicians

List all technician accounts

ninja_get_technician

Get a technician by ID

ninja_list_end_users

List all end users

ninja_get_end_user

Get an end user by ID

ninja_list_user_roles

List all user roles

ninja_list_contacts

List all contacts

Backup (2 tools)

Tool

Description

ninja_get_backup_jobs

Get backup job history and status

ninja_get_integrity_check_jobs

Get backup integrity check results

System (10 tools)

Tool

Description

ninja_list_groups

List all device groups

ninja_get_group_device_ids

Get device IDs for a specific group

ninja_list_scheduled_tasks

List all scheduled automation tasks

ninja_list_automation_scripts

List all automation scripts

ninja_list_notification_channels

List all configured notification channels

ninja_list_custom_fields

List all custom field definitions

ninja_list_locations

List all locations across all organizations

ninja_list_software_products

List all tracked software products

ninja_configure_webhook

Configure a webhook endpoint for NinjaOne events

ninja_disable_webhook

Disable the configured webhook

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

Available Tools

96 tools
ninja_add_ticket_commentC

Add a comment to a ticket.

Inputs: ticketId (required), body (required), htmlBody, public, +2 more.

ninja_approve_devicesA

Approve or reject devices that are pending approval.

Inputs: mode (required), deviceIds (required).

ninja_configure_webhookC

Configure a webhook endpoint to receive NinjaOne events.

Inputs: url (required), secret, activities.

ninja_create_organizationB

Create a new organization (client) in NinjaOne.

Inputs: name (required), description, nodeApprovalMode, tags, +1 more.

ninja_create_organization_locationB

Create a new location for an organization.

Inputs: id (required), name (required), description, address, +4 more.

ninja_create_ticketA

Create a new support ticket. Use ninja_list_ticket_forms to find ticketFormId and ninja_list_ticket_statuses for valid status values.

Inputs: clientId (required), ticketFormId (required), subject (required), requesterUid (required), +10 more.

ninja_disable_webhookB

Disable the configured webhook.

Inputs: no named parameters.

ninja_get_backup_jobsB

Get backup job history and status across managed devices.

Inputs: df, pageSize, cursor.

ninja_get_deviceA

Get full details for a single device by ID.

Inputs: id (required).

ninja_get_device_active_jobsC

Get currently running jobs on a device.

Inputs: id (required).

ninja_get_device_activitiesC

Get activity log for a specific device.

Inputs: id (required), pageSize, newerThan, olderThan, +1 more.

ninja_get_device_alertsB

Get active alerts for a specific device.

Inputs: id (required), lang, tz.

ninja_get_device_custom_fieldsA

Get custom field values assigned to a device.

Inputs: id (required), withInheritance.

ninja_get_device_dashboard_urlA

Get the direct URL to open a device in the NinjaOne web dashboard.

Inputs: id (required).

ninja_get_device_disksB

Get physical disk drive information for a device.

Inputs: id (required).

ninja_get_device_installed_os_patchesC

Get OS patch install history for a device.

Inputs: id (required), status, installedBefore, installedAfter.

ninja_get_device_installed_software_patchesC

Get software patch install history for a device.

Inputs: id (required), status, installedBefore, installedAfter.

ninja_get_device_last_logged_on_userB

Get the last user who logged on to a device.

Inputs: id (required).

ninja_get_device_network_interfacesA

Get network interface information for a device (IP addresses, MAC addresses, adapter type).

Inputs: id (required).

ninja_get_device_os_patchesB

Get pending, failed, or rejected OS patches for a device.

Inputs: id (required), status, type.

ninja_get_device_policy_overridesA

Get policy overrides applied to a specific device.

Inputs: id (required).

ninja_get_device_processorsB

Get CPU/processor information for a device.

Inputs: id (required).

ninja_get_device_scripting_optionsA

Get available scripts and built-in actions that can be run on a device.

Inputs: id (required), lang.

ninja_get_devices_detailedB

List all devices with detailed information including custom fields and policy assignments.

Inputs: df, pageSize, after.

ninja_get_device_softwareC

Get installed software on a device.

Inputs: id (required).

ninja_get_device_software_patchesB

Get pending, failed, or rejected software patches for a device.

Inputs: id (required), status, productIdentifier, type, +1 more.

ninja_get_device_volumesA

Get disk volume information for a device (capacity, free space, filesystem type).

Inputs: id (required).

ninja_get_device_windows_servicesC

Get Windows services and their current status for a device.

Inputs: id (required), name, state.

ninja_get_end_userA

Get an end user by ID.

Inputs: id (required).

ninja_get_group_device_idsB

Get the IDs of all devices in a specific group.

Inputs: id (required).

ninja_get_integrity_check_jobsC

Get backup integrity check job results.

Inputs: df, pageSize, cursor.

ninja_get_organizationC

Get detailed information about a specific organization.

Inputs: id (required).

ninja_get_organization_custom_fieldsC

Get custom field values for an organization.

Inputs: id (required), withInheritance.

ninja_get_organization_devicesC

Get all devices belonging to a specific organization.

Inputs: id (required), df, pageSize, after.

ninja_get_organization_end_usersB

Get end users associated with an organization.

Inputs: id (required).

ninja_get_organization_locationsC

Get all locations for an organization.

Inputs: id (required).

ninja_get_organizations_detailedB

List organizations with detailed settings, policy assignments, and node role mappings.

Inputs: pageSize, after, of.

ninja_get_technicianB

Get a technician account by ID.

Inputs: id (required).

ninja_get_ticketB

Get a ticket and all its details by ID.

Inputs: ticketId (required).

ninja_get_ticket_attributesA

Get the custom attribute definitions available for tickets.

Inputs: no named parameters.

ninja_get_ticket_formA

Get details of a specific ticket form including its fields.

Inputs: id (required).

ninja_get_ticket_logB

Get the activity and change log entries for a ticket.

Inputs: ticketId (required), pageSize, after.

ninja_get_tickets_by_boardB

Query tickets on a specific ticketing board. Use ninja_list_boards to find board IDs.

Inputs: boardId (required), pageSize, pageIndex, sortBy, +1 more.

ninja_list_activitiesB

Get the system activity log. Filter by class (SYSTEM/DEVICE/USER), date range, type, status, user, or device.

Inputs: class, before, after, olderThan, +9 more.

ninja_list_alertsA

Get all active alerts across all devices. Filter by source type or device filter expression.

Inputs: sourceType, df, lang, tz.

ninja_list_automation_scriptsB

List all automation scripts available in NinjaOne.

Inputs: no named parameters.

ninja_list_boardsA

List all available ticketing boards.

Inputs: no named parameters.

ninja_list_contactsC

List all contacts.

Inputs: pageSize, after.

ninja_list_custom_fieldsA

List all custom field definitions configured in NinjaOne.

Inputs: no named parameters.

ninja_list_devicesB

List all managed devices. Use df for device filter expressions (e.g. "org = 1", "status = APPROVED"). Paginate with pageSize and after (last device ID).

Inputs: df, pageSize, after.

ninja_list_end_usersC

List all end users.

Inputs: pageSize, after, organizationId.

ninja_list_groupsA

List all device groups in NinjaOne.

Inputs: no named parameters.

ninja_list_locationsB

List all locations across all organizations.

Inputs: after, pageSize, of.

ninja_list_node_rolesA

List all available device/node roles.

Inputs: no named parameters.

ninja_list_notification_channelsB

List all configured notification channels.

Inputs: no named parameters.

ninja_list_organizationsB

List all organizations (clients/customers) in NinjaOne. Supports filtering and pagination.

Inputs: pageSize, after, of.

ninja_list_policiesA

List all policies configured in NinjaOne.

Inputs: no named parameters.

ninja_list_scheduled_tasksB

List all scheduled automation tasks.

Inputs: no named parameters.

ninja_list_software_productsB

List all software products tracked by NinjaOne (used in patch management).

Inputs: no named parameters.

ninja_list_techniciansB

List all technician accounts.

Inputs: pageSize, after.

ninja_list_ticket_formsA

List all available ticket forms.

Inputs: no named parameters.

ninja_list_ticketing_usersB

List all app users and contacts available in the ticketing system.

Inputs: no named parameters.

ninja_list_ticket_statusesA

List all available ticket statuses.

Inputs: no named parameters.

ninja_list_user_rolesB

List all user roles defined in NinjaOne.

Inputs: no named parameters.

ninja_list_usersA

List all users in NinjaOne. Optionally filter by user type (TECHNICIAN or END_USER).

Inputs: userType.

ninja_query_antivirus_statusB

Query antivirus product status across all managed devices.

Inputs: df, pageSize, cursor.

ninja_query_antivirus_threatsB

Query antivirus threats detected across all managed devices.

Inputs: df, pageSize, cursor.

ninja_query_backup_usageB

Query backup storage usage across all managed devices.

Inputs: df, pageSize, cursor.

ninja_query_computer_systemsB

Query computer system hardware information (make, model, serial number) across all devices.

Inputs: df, pageSize, cursor.

ninja_query_custom_fieldsA

Query custom field values across all devices and organizations.

Inputs: df, pageSize, cursor, fields, +3 more.

ninja_query_device_healthB

Query device health status report (online/offline, alerts, patch compliance).

Inputs: df, pageSize, cursor.

ninja_query_disksB

Query physical disk drive information across all devices.

Inputs: df, pageSize, cursor.

ninja_query_installed_os_patchesB

Query OS patch install history across all managed devices.

Inputs: df, pageSize, cursor, status, +2 more.

ninja_query_installed_software_patchesC

Query software patch install history across all managed devices.

Inputs: df, pageSize, cursor, status, +2 more.

ninja_query_logged_on_usersC

Query the last logged-on user across all managed devices.

Inputs: df, pageSize, cursor.

ninja_query_network_interfacesA

Query network interface information (IPs, MACs, adapters) across all devices.

Inputs: df, pageSize, cursor.

ninja_query_operating_systemsC

Query operating system details (name, version, build) across all devices.

Inputs: df, pageSize, cursor.

ninja_query_os_patchesA

Query pending, failed, or rejected OS patches across all managed devices.

Inputs: df, pageSize, cursor, status, +1 more.

ninja_query_policy_overridesB

Query policy overrides across all managed devices.

Inputs: df, pageSize, cursor.

ninja_query_processorsB

Query CPU/processor information across all managed devices.

Inputs: df, pageSize, cursor.

ninja_query_softwareA

Query software inventory across all managed devices.

Inputs: df, pageSize, cursor, name.

ninja_query_software_patchesB

Query pending, failed, or rejected software patches across all managed devices.

Inputs: df, pageSize, cursor, status, +3 more.

ninja_query_volumesB

Query disk volume information (capacity, free space) across all devices.

Inputs: df, pageSize, cursor.

ninja_query_windows_servicesB

Query Windows service status across all managed devices.

Inputs: df, pageSize, cursor, name, +1 more.

ninja_reboot_deviceA

Reboot a device. NORMAL performs a graceful restart; FORCED immediately reboots without waiting for running processes.

Inputs: id (required), mode (required), reason.

ninja_reset_alertA

Reset (dismiss) an alert by its UID. Optionally provide activityData to record a resolution note.

Inputs: uid (required), activityData.

ninja_run_scriptB

Run a custom script or built-in action on a device. Use ninja_get_device_scripting_options to see what is available.

Inputs: id (required), type, scriptId, uid, +2 more.

ninja_search_devicesA

Search for devices by name, serial number, hostname, or other attributes.

Inputs: q, limit.

ninja_submit_os_patch_applyA

Apply OS patches on a device. Omit patchIds to apply all approved pending patches.

Inputs: id (required), patchIds.

ninja_submit_os_patch_scanB

Trigger an OS patch scan on a device to refresh its pending patch list.

Inputs: id (required).

ninja_submit_software_patch_applyB

Apply software patches on a device. Omit patchIds to apply all approved pending patches.

Inputs: id (required), patchIds.

ninja_submit_software_patch_scanB

Trigger a software patch scan on a device.

Inputs: id (required).

ninja_update_deviceB

Update device settings such as display name, location, role, or policy.

Inputs: id (required), displayName, locationId, nodeRoleId, +2 more.

ninja_update_device_custom_fieldsB

Update custom field values for a device.

Inputs: id (required), fields (required).

ninja_update_organizationC

Update an existing organization.

Inputs: id (required), name, description, nodeApprovalMode.

ninja_update_ticketC

Update an existing ticket (status, subject, assignee, severity, priority, tags, etc.).

Inputs: ticketId (required), status, subject, assignedAppUserId, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 96 tools

    Disambiguation2/5

    The tool set is very large (96 tools) with many overlapping verb-noun pairs like 'getting' versus 'querying' device details. Agents may struggle to distinguish between similar tools such as 'ninja_get_device_os_patches' and 'ninja_query_os_patches', leading to potential misselection.

    Naming Consistency4/5

    All tools consistently follow the pattern 'ninja_verb_noun' (e.g., ninja_create_organization, ninja_list_devices). However, there is slight variation in verb choice (e.g., 'submit' vs 'apply' for patching actions), which is minor.

    Tool Count2/5

    With 96 tools, the server is over-saturated. While the RMM domain is broad, this many tools overwhelm agents and increase cognitive load. A more curated set (20-40) would improve usability.

    Completeness4/5

    The tool set covers most major aspects of device management, ticketing, patching, and querying. Notable gaps include no delete operations for tickets or organizations, but the surface is otherwise comprehensive for typical RMM tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      C
      maintenance
      An MCP server that connects AI assistants to the NinjaOne remote monitoring and management platform via the REST API v2. It provides tools for device inventory, organization management, alert handling, maintenance scheduling, and automated job execution.
      22
      1
      -
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server for Action1, a cloud-native RMM platform, enabling remote monitoring, patch management, and endpoint management through Action1's API.
      6
      5
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server for the NinjaOne RMM platform, enabling tools to manage devices, organizations, alerts, jobs, and policies through NinjaOne's API.
      32
      Apache 2.0