SN MCP server
io.github.ImJaineel/SN-MCP-Server·v2.2.22Multi-instance read-only MCP server for ServiceNow
0 stars32 downloads/wk
Reviews
Write oneNobody has reviewed SN yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
SN tools (16, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
sn_aggregate_tablePerform aggregate queries (count, sum, avg, min, max) on any ServiceNow table
sn_code_searchSearch across all scripting artifacts on a ServiceNow instance using the native
sn_get_attachmentRetrieve attachment metadata or content from a ServiceNow instance using the Attachment API.
sn_get_identityQuery ServiceNow users, groups, and group membership using the Table API.
sn_get_legacy_workflow_artifactsFetch artifacts from the ServiceNow Legacy Workflow Editor using the Table API.
sn_get_recordUniversal record fetcher. Resolves records by sys_id, record number, task type, or CMDB CI class.
sn_get_scripted_artifactsFetch scripting artifacts from any ServiceNow scripting table using the Table API.
sn_get_update_setswrite actionQuery Update Sets and optionally drill into their contents. Two modes:
sn_get_workflow_studio_artifactsFetch artifacts from the ServiceNow Workflow Studio (modern Flow Designer editor)
sn_inspect_tableInspect ServiceNow table metadata. Two modes:
sn_legacy_workflow_searchSearch legacy (classic) workflows by keyword.
sn_list_instancesList all configured ServiceNow instances (aliases, labels, URLs).
sn_pingTest connectivity to a ServiceNow instance.
sn_query_tableGeneric read from any ServiceNow table using the Table API.
sn_read_docsAccess the official ServiceNow AI Platform documentation from
sn_sdk_explainQuery the ServiceNow Now SDK for explanations of SDK skills, APIs, and concepts
Public scan report
scanner v0.1.9 · 2026-09-23 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 46 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How SN compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 57% of 48,255 servers
- Tools
- 16
- the typical server has 7
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 32
- more than 20% of 12,191 servers with a package
What its tools let an agent do: 15 read · 1 change
Install SN in Claude Code, Cursor or VS Code
Runs npx -y @imjaineel-dev/sn-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add SN-MCP-Server -- npx -y @imjaineel-dev/sn-mcp-server
What the publisher says
From the SN repository's README, as published. We do not edit it. Read it on GitHub
📘 SN-MCP-Server
A read-only Model Context Protocol (MCP) server for ServiceNow — built for developers, AI workflows, and tools that need deep visibility into ServiceNow across multiple instances (Prod, Dev, Test, PDI).
<!-- -->
✨ Features
- 🔗 Multi-instance — Prod, Dev, Test, PDI in one server
- 🔍 Powerful querying — Table, Aggregate, Code Search APIs
- 🧠 Intelligent record resolution — INC, CHG, RITM, sys_id
- 🔄 Flow Designer + Legacy Workflows
- 🧩 Schema inspection & discovery
- 👥 Identity & access data
- 🔑 Multiple Auth Methods — Basic Auth and OAuth 2.0 (Client Credentials, Password, Auth Code, JWT)
- 🧰 ServiceNow SDK support — optional snsdkexplain tool is registered when now-sdk is installed globally (npm install -g now-sdk)
- Read-only by design — safe on production instances
- 📄 Per-run log files — one file per server start, stored in OS temp folder
- 🔬 Verbose tool logging — per-call called/received debug lines (instance, args, result summary) when SNMCPVERBOSE=true
- 📚 ServiceNow Docs search — snreaddocs searches the ServiceNowDocs repo, returns filepath/rawurl for direct reads, and can resolve the selected branch when a non-default version is requested
🚀 Quick Start
Option A — npx (no install needed)
npx @imjaineel-dev/sn-mcp-server --config ./sn-instance.jsonOption B — Local clone
git clone https://github.com/ImJaineel/SN-MCP-Server.git
cd SN-MCP-Server
npm install
npm start # auto-detects sn-instance.json in repo root⚙️ Configuration
1. Create sn-instance.json
{
"default": "dev",
"instances": [
{
"alias": "prod",
"label": "Production",
"instance": "mycompany-prod",
"auth": "oauth2",
"grant_type": "client_credentials",
"client_id": "your-client-id",
"client_secret": "your-client-secret"
},
{
"alias": "dev",
"label": "Development",
"instance": "mycompany-dev",
"auth": "basic",
"username": "svc_mcp_readonly",
"password": "your-password-here"
}
]
}📄 Full example: sn-instance.example.json
Common fields
Basic Auth (auth: "basic")
OAuth 2.0 (auth: "oauth2")
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
SN: common questions
- Is SN MCP server safe?
- Mostly: it is graded B (78/100). Read the SN safety report
- How do I install SN?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does SN need an API key?
- Yes. The registry entry asks for
GITHUB_TOKEN. - Is SN maintained?
- The last commit was 87 days ago (2026-08-09). The latest release is v2.2.22.
- How does SN compare with other MCP servers?
- safety score 78/100 (higher than 57% of 48,255 servers); tools 16 (the typical server has 7); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.