@onlyflows/servicenow-mcp

The most comprehensive ServiceNow MCP server. 17 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:

| Feature | Others | @onlyflows/servicenow-mcp | |---------|--------|--------------------------| | Query records | ✅ | ✅ | | Create records | ❌ | ✅ | | Update records | ❌ | ✅ | | Delete records | ❌ | ✅ (with safety confirm) | | Bulk operations | ❌ | ✅ (dry-run by default) | | Aggregations (COUNT/AVG/MIN/MAX/SUM) | ❌ | ✅ | | Table schema introspection | ❌ | ✅ | | CMDB relationship traversal | ❌ | ✅ (recursive, configurable depth) | | Instance health monitoring | ❌ | ✅ (version, nodes, jobs, stats) | | Attachment management | ❌ | ✅ (list, upload, download) | | System log queries | ❌ | ✅ | | Code search across artifacts | ❌ | ✅ | | Table/app/plugin discovery | ❌ | ✅ | | ATF test execution | ❌ | ✅ | | Natural language interface | ❌ | ✅ | | Background scripts | ❌ | ✅ (with Playwright) | | Total tools | 1–3 | 17 |

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

| Tool | Description | |------|-------------| | sn_query | Query any table with encoded queries, field selection, pagination, sorting | | sn_get | Get a single record by sys_id | | sn_create | Create a new record on any table | | sn_update | Update an existing record (PATCH) | | sn_delete | Delete a record (requires confirm: true) | | sn_batch | Bulk update/delete with dry-run safety (requires confirm: true to execute) |

Analytics & Schema

| Tool | Description | |------|-------------| | sn_aggregate | COUNT, AVG, MIN, MAX, SUM with grouping | | sn_schema | Table field definitions, types, references | | sn_health | Instance version, cluster nodes, stuck jobs, key stats |

CMDB & Operations

| Tool | Description | |------|-------------| | sn_relationships | CMDB CI graph traversal — upstream/downstream/both, configurable depth | | sn_attach | List, download, upload attachments | | sn_syslog | Query system logs with severity/source/time filters | | sn_codesearch | Search business rules, script includes, client scripts, etc. | | sn_discover | Discover tables, scoped apps, store apps, plugins |

Testing & Automation

| Tool | Description | |------|-------------| | sn_atf | Run ATF tests and suites, get results | | sn_nl | Natural language → ServiceNow API calls | | sn_script | Execute background scripts (requires Playwright) |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | SN_INSTANCE | ✅ | — | Instance URL (e.g. https://yourinstance.service-now.com) | | SN_USER | ✅ | — | ServiceNow username | | SN_PASSWORD | ✅ | — | ServiceNow password | | SN_DISPLAY_VALUE | ❌ | true | Default display value mode (true, false, all) | | SN_REL_DEPTH | ❌ | 3 | Default CMDB relationship traversal depth |

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 confirm and force flags
• Background scripts require confirm for destructive keywords (deleteRecord, deleteMultiple, etc.)
• Natural language writes require execute: true (reads execute immediately)

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
• [ ] sn_script full implementation with Playwright (SNS-39)
• [ ] Streaming for large result sets
• [ ] Caching for schema and relationship lookups

License

MIT © OnlyFlows