@wellforce/ninjaone-mcp

A NinjaOne RMM MCP server for Claude Desktop. Gives Claude access to 77 NinjaOne tools — manage devices, alerts, tickets, patches, and more through natural language.

Installation

Add to your Claude Desktop config file:

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

{
  "mcpServers": {
    "ninjaone": {
      "command": "npx",
      "args": ["-y", "@wellforce/ninjaone-mcp"],
      "env": {
        "NINJAONE_CLIENT_ID": "your_client_id",
        "NINJAONE_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Restart Claude Desktop. You should see a hammer icon with 77 tools available.

Getting Your API Credentials

1. Log into NinjaOne at Administration > Apps > API
2. Click Add to create a new API application
3. Set the type to Client Credentials (machine-to-machine)
4. Copy the Client ID and Client Secret

Environment Variables

| Variable | Required | Description | Default | |----------|----------|-------------|---------| | NINJAONE_CLIENT_ID | Yes | OAuth2 client ID | — | | NINJAONE_CLIENT_SECRET | Yes | OAuth2 client secret | — | | NINJAONE_REGION | No | API region: us, eu, oc, ca | us | | NINJAONE_SCOPE | No | OAuth2 scopes | monitoring management |

Available Tools (77)

Devices (12)

• ninjaone_list_devices — List devices with optional filters
• ninjaone_get_device — Get a device by ID
• ninjaone_search_devices — Search devices by name or other criteria
• ninjaone_reboot_device — Reboot a device
• ninjaone_set_device_maintenance — Enable/disable maintenance mode
• ninjaone_approve_devices — Approve pending devices
• ninjaone_get_device_activities — Get device activity log
• ninjaone_get_device_dashboard_url — Get device dashboard URL
• ninjaone_get_device_software — List installed software
• ninjaone_get_device_custom_fields — Get custom field values
• ninjaone_update_device_custom_fields — Update custom field values
• ninjaone_get_device_last_user — Get last logged-on user

Organizations (6)

• ninjaone_list_organizations — List all organizations
• ninjaone_get_organization — Get an organization by ID
• ninjaone_get_organization_locations — List organization locations
• ninjaone_get_organization_devices — List devices in an organization
• ninjaone_get_organization_policies — List organization policies
• ninjaone_generate_installer — Generate an agent installer

Alerts (5)

• ninjaone_list_alerts — List active alerts with filters
• ninjaone_get_device_alerts — Get alerts for a specific device
• ninjaone_reset_alert — Reset/acknowledge an alert
• ninjaone_list_alert_conditions — List alert condition definitions
• ninjaone_get_alerts_summary — Get alerts summary/overview

Tickets (5)

• ninjaone_create_ticket — Create a new ticket
• ninjaone_update_ticket — Update ticket properties
• ninjaone_get_ticket_log_entries — Get ticket log entries
• ninjaone_list_board_tickets — List tickets on a board
• ninjaone_add_ticket_comment — Add a comment to a ticket

Queries (18)

• ninjaone_query_antivirus_status — Query antivirus status across devices
• ninjaone_query_antivirus_threats — Query detected antivirus threats
• ninjaone_query_computer_systems — Query computer system information
• ninjaone_query_device_health — Query device health metrics
• ninjaone_query_operating_systems — Query OS information
• ninjaone_query_logged_on_users — Query currently logged-on users
• ninjaone_query_processors — Query processor information
• ninjaone_query_disks — Query disk information
• ninjaone_query_volumes — Query volume information
• ninjaone_query_network_interfaces — Query network interfaces
• ninjaone_query_raid_controllers — Query RAID controllers
• ninjaone_query_raid_drives — Query RAID drives
• ninjaone_query_software — Query installed software
• ninjaone_query_os_patches — Query OS patch status
• ninjaone_query_software_patches — Query software patch status
• ninjaone_query_windows_services — Query Windows services
• ninjaone_query_custom_fields — Query custom field values
• ninjaone_query_backup_usage — Query backup usage

Jobs (3)

• ninjaone_list_jobs — List scheduled/completed jobs
• ninjaone_get_device_jobs — Get jobs for a specific device
• ninjaone_run_script — Run a script on a device

Patches (4)

• ninjaone_scan_os_patches — Scan a device for OS patches
• ninjaone_apply_os_patches — Apply OS patches to a device
• ninjaone_scan_software_patches — Scan for software patches
• ninjaone_apply_software_patches — Apply software patches

Windows Services (3)

• ninjaone_get_windows_services — List Windows services on a device
• ninjaone_control_windows_service — Start/stop/restart a service
• ninjaone_configure_windows_service — Configure service startup type

Maintenance (2)

• ninjaone_create_maintenance_window — Create a maintenance window
• ninjaone_cancel_maintenance — Cancel a maintenance window

Users (6)

• ninjaone_list_end_users — List end users
• ninjaone_get_end_user — Get an end user by ID
• ninjaone_list_technicians — List technicians
• ninjaone_get_technician — Get a technician by ID
• ninjaone_add_role_members — Add users to a role
• ninjaone_remove_role_members — Remove users from a role

Contacts (5)

• ninjaone_list_contacts — List contacts for an organization
• ninjaone_get_contact — Get a contact by ID
• ninjaone_create_contact — Create a new contact
• ninjaone_update_contact — Update contact properties
• ninjaone_delete_contact — Delete a contact

Policies (3)

• ninjaone_list_policies — List all policies
• ninjaone_get_device_policy_overrides — Get policy overrides for a device
• ninjaone_reset_device_policy_overrides — Reset device policy overrides

Groups (1)

• ninjaone_get_group_devices — List devices in a group

Webhooks (2)

• ninjaone_set_webhook — Register a webhook
• ninjaone_delete_webhook — Delete a webhook

Search (1)

• ninjaone_search — Search across all entities

API (1)

• ninjaone_api_call — Make a raw NinjaOne API call

Development

git clone https://github.com/Support-Forge/MCP.git
cd MCP
npm install
npm run build --workspace=packages/ninjaone-mcp
npm test --workspace=packages/ninjaone-mcp

# Watch mode
npm run dev --workspace=packages/ninjaone-mcp

# Test with MCP Inspector
npm run inspect --workspace=packages/ninjaone-mcp

License

MIT