ServiceNow MCP Server

ServiceNow MCP Server

Connect Claude Code, GitHub Copilot, Codex, opencode, Antigravity or any MCP client to ServiceNow:

query any table, read schema and CMDB, review update sets. Free, MIT, works on a free developer instance.

uvx mcp-server-servicenow gives an AI assistant the ServiceNow developer data plane: the Table API, the data dictionary, Stats API aggregates, the CMDB and update sets, on any release from Tokyo up. It runs alongside ServiceNow's own MCP servers (how they differ).

What you can ask

• *"Which fields does cmdb_ci_server have, including inherited ones?"*
• *"Who holds admin, and which roles are granted directly instead of through a group?"*
• *"Review update set 'Q3 fixes' before I promote it."*
• *"Which server CIs are missing an IP address or an owner?"*
• *"How many open incidents does each assignment group have?"* (any table works, not just the platform ones)

Quick start

About ten minutes on a free developer instance. On a company instance, ask your ServiceNow admin for the user in step 2.

1. Get a ServiceNow instance

Sign up for a free Personal Developer Instance (PDI) — it comes with demo incidents, changes and CIs. PDIs hibernate after a few hours idle: wake yours from the developer portal before you start.

2. Create an integration user

Don't connect as admin: new instances refuse REST basic auth for it (why), and the server needs far less.

1. Sign in as admin and go to All › User Administration › Users › New.
2. User ID mcp.integration, Identity type *Machine* (this ticks Web service access only), and tick Internal Integration User. If your form has no Identity type, tick Web service access only yourself. Submit, then open the user again.
3. Set Password, and keep the password for step 3.
4. Roles › Edit: add itil and snc_read_only, save.

That user can read incidents, changes, problems, CMDB and aggregates, and can't change anything. Schema, update sets and writes need more: see roles.

3. Add the server to your client

You need uv (uvx runs the server without installing it). In Claude Code:

read -rs SERVICENOW_PASSWORD     # paste the password; it is not shown or kept in your history

claude mcp add servicenow \ -e SERVICENOW_INSTANCE_URL=https://devNNNNNN.service-now.com \ -e SERVICENOW_USERNAME=mcp.integration \ -e SERVICENOW_PASSWORD="$SERVICENOW_PASSWORD" \ -- uvx mcp-server-servicenow

Or install the Claude Code plugin, which adds the four skills as slash commands. It reads the same SERVICENOW_* variables from the shell that starts Claude Code (details):

claude plugin marketplace add jschuller/mcp-server-servicenow

claude plugin install servicenow@mcp-server-servicenow

Windows (PowerShell)

Install uv with winget install astral-sh.uv, then:

$s = Read-Host 'Password' -AsSecureString

$p = [Runtime.InteropServices.Marshal]::PtrToStringBSTR([Runtime.InteropServices.Marshal]::SecureStringToBSTR($s)) claude mcp add servicenow -e SERVICENOW_INSTANCE_URL=https://devNNNNNN.service-now.com -e SERVICENOW_USERNAME=mcp.integration -e "SERVICENOW_PASSWORD=$p" -- uvx mcp-server-servicenow

</details>

VS Code (GitHub Copilot)

The button adds the server to your VS Code user profile and asks for the instance URL, user and password on first start, storing the password securely. Or add this to .vscode/mcp.json. Use Copilot Chat in Agent mode.

{

"inputs": [ { "type": "promptString", "id": "servicenow-url", "description": "ServiceNow instance URL, e.g. https://devNNNNNN.service-now.com" }, { "type": "promptString", "id": "servicenow-password", "description": "Password for mcp.integration", "password": true } ], "servers": { "servicenow": { "type": "stdio", "command": "uvx", "args": ["mcp-server-servicenow"], "env": { "SERVICENOW_INSTANCE_URL": "${input:servicenow-url}", "SERVICENOW_USERNAME": "mcp.integration", "SERVICENOW_PASSWORD": "${input:servicenow-password}" } } } }

</details>

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{

"mcpServers": { "servicenow": { "command": "uvx", "args": ["mcp-server-servicenow"], "env": { "SERVICENOW_INSTANCE_URL": "https://devNNNNNN.service-now.com", "SERVICENOW_USERNAME": "mcp.integration", "SERVICENOW_PASSWORD": "your-password" } } } }

</details>

Codex, opencode, Antigravity, Cursor, pi, the Claude Code plugin and keeping the password out of config files: client setup.

4. Check it works

Ask: *"List the 5 most recent incidents."* The start-here user holds snc_read_only, so the server lists only the 13 read-only tools. Give the user write roles (and remove snc_read_only) and the 7 write tools appear; your client asks before each write.

No answer? Run the same configuration with --check. It makes read-only requests, prints one line per check (instance reachable, identity, roles, table read, schema, aggregates) and never prints a secret:

SERVICENOW_INSTANCE_URL=https://devNNNNNN.service-now.com SERVICENOW_USERNAME=mcp.integration \

SERVICENOW_PASSWORD="$SERVICENOW_PASSWORD" uvx mcp-server-servicenow --check

Got an answer back? Say which client and ServiceNow release in Show and tell — it tells us what works. Questions go to Q&A.

If it doesn't work

Everything else: run --check (above), then TROUBLESHOOTING.

Tools

20 tools, 5 resources and 4 skills. Full reference: tools, resources and skills.

Resources: table schemas, instance info, the current update set, the CMDB class hierarchy and an encoded-query reference — read without a tool call.

Skills: four guided workflows for the Now Platform, served over MCP as skill:// resources so every client gets them with no plugin:

• exploring-tables: schemas, choice lists, a record's history, what touches a table or field, the encoded-query reference;
• analyzing-access: who holds which roles, team rosters and group members, and what a 403 or a missing field means;
• reviewing-update-sets: risk categories and a pre-promotion checklist;
• servicenow-cmdb: CMDB data quality and CSDM conformance.

To run with the tools only, add the server without the plugin (claude mcp add, or an mcp.json entry) and set SERVICENOW_SKILLS=off (or --skills off). off changes only what the server serves: the Claude Code plugin still loads the four skills from its own folder (configuration).

Community skills: skills for applications such as ITSM, and for your own conventions, live in their authors' repositories, each with its own eval results:

• EXTENDING.md covers writing, validating, testing with mocked tools, and sharing them;
• to find them, browse the servicenow-mcp-skill topic and Discussions › Skills. This project doesn't vet them.

The incident triage skill that shipped here until 0.9.0 is now an example.

Roles

ServiceNow's ACLs decide what the user can do; the server adds nothing on top.

| …and delete incidents, problems