NinjaOne MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NinjaOne MCP Server show me all Windows servers with low disk space"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_credentialsauthentication with automatic token refreshPagination and device filter (
df) support on all list endpointsZero runtime dependencies beyond
axiosand the MCP SDK
Related MCP server: action1-mcp
Prerequisites
Node.js 18 or later
A NinjaOne account with API access
OAuth2 API credentials (see Obtaining Credentials)
Obtaining Credentials
Log in to your NinjaOne portal and go to Administration → Apps → API
Click Add to create a new API application
Select Client Credentials as the authorization flow
Grant the scopes your use case requires:
monitoring— read-only device/alert datamanagement— manage devices, organizations, policiescontrol— run scripts, trigger patch jobs, reboot devices
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 |
|
EU |
|
OC |
|
CA |
|
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 buildOption 2 — Run directly with tsx (dev/testing)
git clone https://github.com/Allied-Business-Solutions/ninjaone-mcp.git
cd ninjaone-mcp
npm installThen use npm run dev instead of node dist/index.js in the config below.
Configuration
Environment Variables
Variable | Required | Description |
| Yes | NinjaOne instance URL (e.g. |
| Yes | OAuth2 client ID from the NinjaOne Developer Portal |
| 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 credentialsClaude Desktop
Add the following to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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.jsOther 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 |
| List all managed devices with optional device filter ( |
| Get full details for a single device by ID |
| List devices with detailed settings and policy assignments |
| Search devices by name, hostname, or serial number |
| Update device display name, location, role, or policy |
| Get the activity log for a device |
| Get active alerts on a device |
| List installed software on a device |
| Get pending/failed/rejected OS patches |
| Get OS patch install history |
| Get pending/failed/rejected software patches |
| Get software patch install history |
| Get disk volume info (capacity, free space, filesystem) |
| Get physical disk drive info |
| Get network adapters, IPs, and MAC addresses |
| Get CPU/processor details |
| Get Windows service status |
| Get the last user who logged on |
| Get currently running jobs on a device |
| Get the direct URL to a device in the NinjaOne dashboard |
| List scripts and actions available for a device |
| Get custom field values for a device |
| Update custom field values on a device |
| Reboot a device (NORMAL or FORCED mode) |
| Run a custom script or built-in action on a device |
| Trigger an OS patch scan |
| Apply OS patches |
| Trigger a software patch scan |
| Apply software patches |
| Approve or reject pending device registrations |
Organizations (10 tools)
Tool | Description |
| List all organizations (clients) with pagination |
| List organizations with full settings and policy mappings |
| Get details for a specific organization |
| Create a new organization |
| Update an organization's name, description, or approval mode |
| List all devices in an organization |
| List all locations for an organization |
| Create a new location for an organization |
| Get custom field values for an organization |
| Get end users associated with an organization |
Alerts (2 tools)
Tool | Description |
| Get all active alerts across all devices |
| Dismiss/reset an alert by UID, optionally adding a resolution note |
Activities (1 tool)
Tool | Description |
| Query the system activity log with filters for class, date range, type, user, and device |
Ticketing (12 tools)
Tool | Description |
| Create a new support ticket |
| Get a ticket by ID |
| Update ticket status, assignee, severity, priority, or tags |
| Add a public or private comment to a ticket |
| Get the change log for a ticket |
| Query tickets on a specific board |
| List all ticketing boards |
| List all available ticket statuses |
| List all ticket forms |
| Get details and fields for a specific ticket form |
| List app users and contacts available in ticketing |
| Get custom attribute definitions for tickets |
Queries / Reports (19 tools)
All query tools support df (device filter), pageSize, and cursor for pagination.
Tool | Description |
| AV product status across all devices |
| AV threats detected across all devices |
| Device health report (online/offline, alerts, patch compliance) |
| Pending/failed/rejected OS patches fleet-wide |
| Pending/failed/rejected software patches fleet-wide |
| OS patch install history fleet-wide |
| Software patch install history fleet-wide |
| Software inventory fleet-wide |
| Last logged-on user fleet-wide |
| Hardware info (make, model, serial) fleet-wide |
| OS name, version, and build fleet-wide |
| Network interface info fleet-wide |
| Physical disk info fleet-wide |
| Disk volume info fleet-wide |
| Windows service status fleet-wide |
| Custom field values fleet-wide |
| CPU info fleet-wide |
| Backup storage usage fleet-wide |
| Policy overrides fleet-wide |
Policies (4 tools)
Tool | Description |
| List all policies |
| Get policy overrides for a specific device |
| Query policy overrides across all devices |
| List all available device/node roles |
Users (7 tools)
Tool | Description |
| List all users (technicians and end users) |
| List all technician accounts |
| Get a technician by ID |
| List all end users |
| Get an end user by ID |
| List all user roles |
| List all contacts |
Backup (2 tools)
Tool | Description |
| Get backup job history and status |
| Get backup integrity check results |
System (10 tools)
Tool | Description |
| List all device groups |
| Get device IDs for a specific group |
| List all scheduled automation tasks |
| List all automation scripts |
| List all configured notification channels |
| List all custom field definitions |
| List all locations across all organizations |
| List all tracked software products |
| Configure a webhook endpoint for NinjaOne events |
| 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 = MACDevelopment
# Run in dev mode (no build step required)
npm run dev
# Type-check and compile
npm run build
# Start the compiled server
npm startProject 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 toolsLicense
MIT
Available Tools
96 toolsninja_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
Scored across 96 tools
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.
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.
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.
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
Related MCP Connectors
Hosted MCP servers for MSP tools: ConnectWise, NinjaOne, Microsoft 365, SentinelOne, Pax8 and more.
AI-powered incident management and server monitoring via MCP.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Single-connection MCP gateway discovering and executing 490+ verified MCP & A2A tools.
Related MCP Servers
- FlicenseAqualityCmaintenanceAn 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.221-
- AlicenseAqualityBmaintenanceAn MCP server for Action1, a cloud-native RMM platform, enabling remote monitoring, patch management, and endpoint management through Action1's API.65Apache 2.0
- AlicenseNot gradedqualityBmaintenanceAn MCP server for the NinjaOne RMM platform, enabling tools to manage devices, organizations, alerts, jobs, and policies through NinjaOne's API.32Apache 2.0
- AlicenseAqualityDmaintenanceMCP server enabling AI assistants to interact with your LogicMonitor, providing 125 tools for comprehensive monitoring and management operations.7090 npm14AGPL 3.0