servicenow-mcp
<div align="center">
<img src="https://raw.githubusercontent.com/aartiq/servicenow-mcp/main/docs/assets/banner.png" alt="NowAIKit ServiceNow MCP Server" width="100%"/>
[](https://www.npmjs.com/package/nowaikit)
[](docs/TOOLS.md)
[](https://modelcontextprotocol.io)
[](LICENSE)
# ServiceNow MCP Server (NowAIKit)
**Connect Claude, ChatGPT, Gemini, Cursor, Copilot, or any AI, to ServiceNow.**
500+ tools across ITSM, ITOM, CMDB, HRSD, CSM, Flow Designer, scripting & portal. Read, build, query and automate any instance in plain English.
New in 4.4 to 4.7: impact analysis (list_table_config / find_field_references / find_script_references) to see what depends on a table, field or script before you change it, Local Sync to pull artifacts to local files, and aggregate_report for server-side reports (count plus averages, no truncation).
</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](https://cloud.nowaikit.com)** (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](docs/CLIENT_SETUP.md)** Β· **[OAuth setup](docs/SERVICENOW_OAUTH_SETUP.md)**.
No instance? Grab a free Personal Developer Instance at **[developer.servicenow.com](https://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](docs/INSTALLATION.md) Β· [Client setup](docs/CLIENT_SETUP.md) | [All 500+ tools](docs/TOOLS.md) Β· [Tool packages](docs/TOOL_PACKAGES.md) |
| [Multi-instance](docs/MULTI_INSTANCE.md) Β· [OAuth](docs/SERVICENOW_OAUTH_SETUP.md) | [Scripting](docs/SCRIPTING.md) Β· [ATF](docs/ATF.md) Β· [Reporting](docs/REPORTING.md) |
Full guides & product home β **[nowaikit.com](https://nowaikit.com)**
---
## π§© Part of the NowAIKit suite
- π **[nowaikit.com](https://nowaikit.com)** β docs, guides & product home
- βοΈ **[NowAIKit Cloud](https://cloud.nowaikit.com)** β the toolkit in your browser, no install
- π¦ **[`nowaikit-sdk`](https://www.npmjs.com/package/nowaikit-sdk)** β TypeScript ServiceNow client library
- π§° **NowAIKit Builder** (VS Code) Β· **NowAIKit Utils** (browser extension)
> **β οΈ Official distribution only:** install from **npm (`nowaikit`)** or **[nowaikit.com](https://nowaikit.com)**. NowAIKit is never shipped as a downloadable GitHub `.zip` β beware copycat "download" repos.
---
Β© 2026 NowAIKit Β· Source available under the [Elastic License 2.0](LICENSE)
TDQS
Scored across 558 tools
The set contains many overlapping tools: generic CRUD (query_records, get_record, create_record, update_record, delete_record) coexists with table-specific tools (get_incident, create_incident, update_incident), dynamic_* tools, fluent_sdk_query, batch_request, and multiple query/aggregation tools (run_aggregate_query, aggregate_report, trend_query, visualize_aggregate). Script execution is spread across execute_script, execute_background_script, fluent_exec, and run_fix_script. Descriptions help somewhat, but with 558 tools an agent faces frequent boundary ambiguity.
Most names are snake_case and readable, but conventions vary widely: prefix families (fluent_*, sn_mcp_*, sn_a2a_*, cmdb_*, ml_*, csm_*, hr_*), noun-first names (service_health, change_readiness, investigate_incident, ask_otto), and action-oriented names (open_record_form, send_emergency_broadcast). It is not chaotic, but it lacks a single predictable verb_noun pattern.
558 tools is an extreme over-provision for any single MCP server surface, far beyond the 3β15 well-scoped norm. Even with search_tools and lean discovery, the default surface is enormous and difficult to navigate, indicating a severe count mismatch.
The surface is extremely broad, covering ITSM, CSM, HRSD, GRC, CMDB, PA, Flow Designer, portals, mobile, AI governance, and generic table CRUD via dynamic tools. There may be niche gaps, but agents can nearly always find or construct a path for common workflows.