ServiceNow MCP

Option B — Docker

No prebuilt image is published yet — build it from the included Dockerfile:

git clone https://github.com/dariomba/veldev-servicenow-mcp.git
cd veldev-servicenow-mcp
docker build -t veldev-servicenow-mcp .

docker run -p 3000:3000 \
  -e SN_INSTANCE=https://your-instance.service-now.com \
  -e SN_USERNAME=admin \
  -e SN_PASSWORD=yourpassword \
  veldev-servicenow-mcp

---

Quick start

Example prompts

List all active catalog items in the "Hardware" category

Get the full definition of the "Laptop Request" catalog item, including variables and UI policies

What client scripts are on the New Employee Onboarding item?

Create a new catalog item called "VPN Access Request" with a text variable for business justification

Create a business rule on incident that sets priority to 1 when impact and urgency are both 1

Create an onLoad client script on incident that shows an info message when the priority is 1 - Critical

Create a record producer called "New Hire Equipment" that generates an sc_req_item record, with a pre-insert script that maps the selected laptop model to the item field

Create a fix script called "Backfill Incident SLAs" that queries all incidents missing an SLA and sets a default one

Run the fix script with sys_id 18f9eee1c3d1479043e1fc0d0501315e

Register an event "x_acme.contract.signed" on a custom queue, then create a script action that emails the account owner when it fires

Create an update set called "VPN Catalog Work" and make it my current set

List my in-progress update sets, then switch to "VPN Catalog Work"

Create an ATF test that submits the "VPN Access Request" catalog item and verifies the generated request record, mapping the record from the submit step into a server-side validation step

---

Option A — Local (recommended)

```bash git clone https://github.com/dariomba/veldev-servicenow-mcp.git cd veldev-servicenow-mcp npm install

Configure credentials

cp .env.example .env

Edit .env with your instance URL, username, password

Configuration

Copy .env.example to .env to configure.

¹ Required when SN_AUTH_TYPE=basic or SN_GRANT_TYPE=password ² Required when SN_AUTH_TYPE=oauth

Free PDI: Don't have a ServiceNow instance? Get a free Personal Developer Instance at developer.servicenow.com.

---

Edit .env: set SN_INSTANCE, SN_USERNAME, SN_PASSWORD for a throwaway PDI

```

Claude Code / Cursor / VS Code (stdio)

For clients that spawn the server as a subprocess, create a .mcp.json file in your project root:

{
  "mcpServers": {
    "servicenow": {
      "command": "node",
      "args": ["/path/to/veldev-servicenow-mcp/build/index.js"],
      "env": {
        "TRANSPORT": "stdio",
        "SN_INSTANCE": "https://your-instance.service-now.com",
        "SN_USERNAME": "admin",
        "SN_PASSWORD": "yourpassword"
      }
    }
  }
}

Or run from source (no build step needed):

{
  "mcpServers": {
    "servicenow": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "/path/to/veldev-servicenow-mcp",
      "env": {
        "TRANSPORT": "stdio",
        "SN_INSTANCE": "https://your-instance.service-now.com",
        "SN_USERNAME": "admin",
        "SN_PASSWORD": "yourpassword"
      }
    }
  }
}

---