@onlyflows/servicenow-mcp
The most comprehensive ServiceNow MCP server. 16 tools for full CRUD, CMDB graph traversal, background scripts, ATF testing, and more.
Built by OnlyFlows · Published by @onlyflowstech
Why This MCP Server?
Most ServiceNow MCP integrations are read-only and support a handful of tables. This one gives your AI assistant full access to the ServiceNow platform:
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"servicenow": {
"command": "npx",
"args": ["-y", "@onlyflows/servicenow-mcp"],
"env": {
"SN_INSTANCE": "https://yourinstance.service-now.com",
"SN_USER": "your_username",
"SN_PASSWORD": "your_password"
}
}
}
}
Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
{
"mcpServers": {
"servicenow": {
"command": "npx",
"args": ["-y", "@onlyflows/servicenow-mcp"],
"env": {
"SN_INSTANCE": "https://yourinstance.service-now.com",
"SN_USER": "your_username",
"SN_PASSWORD": "your_password"
}
}
}
}
Windsurf
Add to your Windsurf MCP configuration:
{
"mcpServers": {
"servicenow": {
"command": "npx",
"args": ["-y", "@onlyflows/servicenow-mcp"],
"env": {
"SN_INSTANCE": "https://yourinstance.service-now.com",
"SN_USER": "your_username",
"SN_PASSWORD": "your_password"
}
}
}
}
VS Code (Copilot)
Add to .vscode/mcp.json:
{
"servers": {
"servicenow": {
"command": "npx",
"args": ["-y", "@onlyflows/servicenow-mcp"],
"env": {
"SN_INSTANCE": "https://yourinstance.service-now.com",
"SN_USER": "your_username",
"SN_PASSWORD": "your_password"
}
}
}
}
Tools Reference
Core CRUD
Analytics & Schema
CMDB & Operations
Testing & Automation
Environment Variables
Usage Examples
Once connected, your AI assistant can:
Query incidents:
"Show me all P1 incidents assigned to the Network team"
Create a record:
"Create an incident for VPN outage affecting 50 users, P2, assign to Network Operations"
Aggregate data:
"How many incidents are there grouped by priority?"
Check health:
"Run a health check on our ServiceNow instance"
CMDB traversal:
"Show all upstream dependencies for the email-server-01 CI"
Schema introspection:
"What fields are on the change_request table?"
Code search:
"Find all business rules that reference GlideRecord('incident')"
ATF testing:
"Run ATF test suite abc123 and wait for results"
Safety Features
This server is designed for production use with multiple safety layers:
- Delete operations require explicit
confirm: true - Batch operations run in dry-run mode by default — shows match count without making changes
- Bulk deletes require both
confirmandforceflags - Background scripts require
confirmfor destructive keywords (deleteRecord,deleteMultiple, etc.)
Development
# Clone
git clone https://github.com/onlyflowstech/servicenow-mcp.git
cd servicenow-mcp
# Install & build
npm install
npm run build
# Run locally
SN_INSTANCE=https://yourinstance.service-now.com \
SN_USER=your_user \
SN_PASSWORD=your_pass \
node dist/index.js
# Watch mode
npm run dev
Testing with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js
Roadmap
- SSE transport for remote hosting
- OAuth 2.0 authentication support
- run_background_script full implementation with Playwright (SNS-39)
- Streaming for large result sets
- Caching for schema and relationship lookups
License
MIT © OnlyFlows