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.**
450+ 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 450+ 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 496 tools
There are many overlapping tool categories with similar purposes, such as multiple list methods for cases (list_csm_cases, list_hr_cases, list_security_incidents), each with similar functionalities. Also, there is overlap between generic query tools (query_records, fluent_query) and specialized getters, and between 'create_*' tools and generic create_record, leading to potential selection confusion for agents.
Most tools follow a verb_noun pattern (e.g., get_incident, create_change_request, list_assets), but there are inconsistencies like 'run_transform_map' vs 'execute_script', and some tools use different verb styles (e.g., 'cmdb_find_duplicates' vs 'list_cmdb_cis'). Additionally, a few tools have no clear verb (e.g., 'discover_table', 'find_field_references') and some use bare resource names (e.g., 'nlq_query') that break the pattern.
With 496 tools, this is a massive over-expansion for a single MCP server. Even for a comprehensive platform like ServiceNow, this exceeds any reasonable tool surface for an agent, causing context bloat and poor navigability. The tool count is extreme and will overwhelm agents with too many choices, defeating the purpose of MCP as a concise tool interface.
The tool set covers a vast array of ServiceNow modules with CRUD operations for most (cases, incidents, problems, change, HR, CMDB, portals, etc.), including lifecycle management and reporting. However, some notable gaps exist, such as no dedicated tool for updating HR case activities or managing knowledge base permissions, and some advanced features like custom tables might rely on generic record tools. Overall, it's fairly complete for the scope, but the sheer size masks some specific missing operations.