io.github.aartiq/servicenow-mcp

Official

by aartiq · TypeScript

ServiceNow MCP Server

400+ ServiceNow tools across all modules — ITSM, CMDB, HRSD, CSM, SecOps, and more.

Access 400+ ServiceNow tools for ITSM, CMDB, HRSD, CSM, and SecOps modules.

Topics

automationcmdbitomitsmmcpmodel-context-protocolservicenowtypescriptclaudegeminiaiai-agentai-toolsanthropicchatgptllmservicenow-developerservicenow-integrationservicenow-mcpservicenow-ai

README.md4 KBView on GitHub

NowAIKit — ServiceNow MCP Server

Connect Claude, ChatGPT, Gemini, Cursor, Copilot — or any AI — to ServiceNow.

450+ tools across ITSM, ITOM, CMDB, HRSD, CSM, Flow Designer, scripting & portal. Read, build, query and automate any instance in plain English.

</div>

🚀 Install (2 minutes)

Requires Node.js 20+.

bash

# 1 — install
npm install -g nowaikit

# 2 — run the wizard: it detects your AI clients and writes their config for you
npx nowaikit setup

Restart your AI client (Claude Desktop, Cursor, …) and start asking. Done.

Prefer a UI? npx nowaikit web for a local dashboard — or use NowAIKit Cloud (nothing to install).

🔌 Manual setup (skip the wizard)

Add this to your client's MCP config (Claude Desktop claude_desktop_config.json, Cursor ~/.cursor/mcp.json, etc.):

json

{
  "mcpServers": {
    "nowaikit": {
      "command": "npx",
      "args": ["-y", "nowaikit"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://yourcompany.service-now.com",
        "SERVICENOW_BASIC_USERNAME": "your_username",
        "SERVICENOW_BASIC_PASSWORD": "your_password"
      }
    }
  }
}

OAuth, multiple instances, and per-client steps → Client setup · OAuth setup.

No instance? Grab a free Personal Developer Instance at developer.servicenow.com.

💬 Use it — just ask

"How many active P1 incidents are open right now?"
"Show me the 5 most recent changes and their risk."
"Create a business rule on the incident table that…"
"Run the ATF suite for the HR onboarding flow."
"What's the CMDB health for our prod CIs?"
"Look up GlideRecord.addEncodedQuery in the ServiceNow docs and show the syntax."

Read-only by default. Write, scripting and CMDB changes are opt-in flags — prod can't be modified by accident.

📚 Docs


Installation · Client setup	All 450+ tools · Tool packages
Multi-instance · OAuth	Scripting · ATF · Reporting

Full guides & product home → nowaikit.com

🧩 Part of the NowAIKit suite

🌐 nowaikit.com — docs, guides & product home
☁️ NowAIKit Cloud — the toolkit in your browser, no install
📦 nowaikit-sdk — TypeScript ServiceNow client library
🧰 NowAIKit Builder (VS Code) · NowAIKit Utils (browser extension)

⚠️ Official distribution only: install from npm (nowaikit) or nowaikit.com. NowAIKit is never shipped as a downloadable GitHub .zip — beware copycat "download" repos.

Install

Configuration

Environment variables

SERVICENOW_INSTANCE_URL

Your ServiceNow instance URL (e.g. https://yourinstance.service-now.com)

SERVICENOW_AUTH_METHOD

Authentication method: 'basic' or 'oauth'

SERVICENOW_BASIC_USERNAME

ServiceNow username (for basic auth)

SERVICENOW_BASIC_PASSWORD

ServiceNow password (for basic auth)

WRITE_ENABLED

Enable write operations (true/false, default: false)

SCRIPTING_ENABLED

Enable scripting operations (true/false, default: false)

CMDB_WRITE_ENABLED

Enable CMDB write operations (true/false, default: false)

NOW_ASSIST_ENABLED

Enable Now Assist AI features (true/false, default: false)

ATF_ENABLED

Enable ATF test execution (true/false, default: false)

MCP_TOOL_PACKAGE

Role-based tool package: full, service_desk, platform_developer, etc.

claude_desktop_config.json

{
  "mcpServers": {
    "servicenow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@aartiq/servicenow-mcp@1.0.2"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "<YOUR_SERVICENOW_INSTANCE_URL>",
        "SERVICENOW_AUTH_METHOD": "<YOUR_SERVICENOW_AUTH_METHOD>",
        "SERVICENOW_BASIC_USERNAME": "<YOUR_SERVICENOW_BASIC_USERNAME>",
        "SERVICENOW_BASIC_PASSWORD": "<YOUR_SERVICENOW_BASIC_PASSWORD>",
        "WRITE_ENABLED": "<YOUR_WRITE_ENABLED>",
        "SCRIPTING_ENABLED": "<YOUR_SCRIPTING_ENABLED>",
        "CMDB_WRITE_ENABLED": "<YOUR_CMDB_WRITE_ENABLED>",
        "NOW_ASSIST_ENABLED": "<YOUR_NOW_ASSIST_ENABLED>",
        "ATF_ENABLED": "<YOUR_ATF_ENABLED>",
        "MCP_TOOL_PACKAGE": "<YOUR_MCP_TOOL_PACKAGE>"
      }
    }
  }
}