home / mcp / servicenow mcp server

ServiceNow MCP Server

A multi-instance MCP server with dynamic schema discovery, 44 tools, and 160+ ServiceNow tables for CRUD, ITSM, CMDB, and automation tasks.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "happy-technologies-llc-mcp-servicenow-nodejs": {
      "command": "node",
      "args": [
        "/Users/YOUR_USERNAME/WebstormProjects/mcp-servicenow-nodejs/src/stdio-server.js"
      ],
      "env": {
        "SERVICENOW_PASSWORD": "your-password",
        "SERVICENOW_USERNAME": "your-username",
        "SERVICENOW_AUTH_TYPE": "basic",
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com"
      }
    }
  }
}

You can run a multi-instance ServiceNow MCP Server that automatically discovers schema, routes tools to the right instance, and provides a rich set of CRUD and ITSM operations across 160+ ServiceNow tables. This server supports local development, multi-instance configuration, and integration with Claude Desktop for streamlined AI-assisted workflows.

How to use

You will connect to the MCP server from your client or Claude Desktop. The server supports multi-instance routing, so you can perform operations on any configured ServiceNow instance by including an instance field in your tool calls. You can test the health endpoint to verify the server is running, list configured instances, and use the built-in MCP Inspector to explore available tools and responses. You can also use the Claude Desktop integration to run tools locally via a dedicated stdio transport.

Typical usage patterns include listing records from a table using generic CRUD tools, performing ITSM operations with convenience tools, and running natural language searches to translate plain English queries into ServiceNow queries. When you call a tool without an instance parameter, the default instance from your configuration is used. When you include an instance parameter, the call targets the specified instance.

How to install

Prerequisites you need before installing: Node.js 18+ and access to one or more ServiceNow instances with API credentials.

Step by step setup and installation:

Clone the project repository and install dependencies.

Configure your ServiceNow instances in a multi-instance config file.

Start the MCP server in development mode.

Verify the server health and the configured instances.

Available tools

SN-List-Incidents

List incidents with optional filters and limits across a specified table. Supports instance routing.

SN-Create-Incident

Create a new incident record with required fields and optional attributes in a target instance.

SN-Get-Incident

Retrieve a single incident by sys_id from a specific or default instance.

SN-Update-Record

Update a record in a given table using sys_id and a data payload.

SN-Query-Table

Query a table with a complex encoded query and return selected fields.

SN-Execute-Background-Script

Run a background script (e.g., via sys_trigger) and return execution results.

SN-Get-Current-Update-Set

Inspect the current update set for the active or specified instance.

SN-Set-Update-Set

Set the active update set by sys_id for the given instance.

SN-Move-Records-To-Update-Set

Move records into a target update set, supporting Default and other sets.

SN-Batch-Create

Batch create multiple records across tables in a single operation.

SN-Batch-Update

Batch update multiple records across tables in a single operation.

SN-Get-Table-Schema

Retrieve the schema for a specified table, including fields.

SN-Discover-Table-Schema

Discover table schema with relationships and constraints.

SN-Create-Workflow

Create a workflow with activities and transitions for a specified table.

SN-Create-Flow

Create and configure a Flow Designer flow and its components (NEW).

SN-Natural-Language-Search

Perform a natural language query against a table and translate it to an encoded query.

SN-Incident-Add-Comment

Add a user-visible comment to an incident.

SN-Incident-Add-Work-Notes

Add internal work notes to an incident.

SN-Incident-Assign

Assign an incident to a user or group.

SN-Incident-Resolve

Resolve an incident with resolution details.

SN-Incident-Close

Close an incident with close notes and code.

SN-Update-Table-And-Fields

Update multiple fields on a table record.

SN-Get-Update-Set-Dependencies

Retrieve dependencies for an update set.

SN-List-Service-Catalog

List catalog items and related records.

SN-Create-Workflow-Activity

Create a workflow activity for a given workflow.

SN-Query-Table-Full

Query a table with full field list and complex filters.

SN-Get-Relation-Ship

Retrieve relationships for a table schema.

SN-Execute-Fix-Script

Execute a fix script against an instance.

SN-List-UI-Policies

List UI policies for a table and related UI actions.

SN-List-REST-Messages

List REST messages configured on an instance.

SN-List-Rest-Definitions

List REST message definitions and endpoints.

SN-List-Import-Sets

List import sets and their mappings.

SN-Discover-Table-Relationships

Discover and return table relationships.

SN-Get-Table-Options

Query item options for a catalog item.

SN-Get-User-Info

Fetch user information from sys_user and related roles/groups.

SN-Get-Group-Info

Fetch group information and membership.

SN-Get-Record-Likely-Duplicates

Identify potential duplicate records across the same table.