Model Context Protocol

v1.0.0

MIT License

The USB-C of ServiceNow + AI

One protocol. Every AI assistant. Full ServiceNow access.

Connect Claude, Cursor, VS Code, or any MCP-compatible client to your ServiceNow instance. Query records, create incidents, run analytics — all through natural conversation.

Built by Brandon Wilson for OnlyFlows.

View on npm Star on GitHub

What does the ServiceNow MCP Server enable?

The ServiceNow MCP Server connects MCP-compatible AI clients to ServiceNow through a reusable protocol layer. It is designed for teams that want vendor-agnostic AI connectivity, direct table access, and a practical bridge between AI clients and ServiceNow operations.

Key Takeaways

Works across MCP-capable clients instead of tying you to one AI interface.
Brings structured ServiceNow access to high-intent AI workflows.
Connects naturally to the wider OnlyFlows entity, product, and editorial ecosystem.
Benefits from glossary and comparison support when buyers are still evaluating protocol-based integration approaches.

What is MCP?

The Model Context Protocol is an open standard by Anthropic that lets AI assistants connect to external tools and data sources. Think of it as USB-C for AI — one universal plug that works everywhere.

Universal Protocol

One server works with Claude Desktop, Cursor, VS Code, and any MCP-compatible client. No vendor lock-in.

Runs Locally

Your ServiceNow credentials never leave your machine. The MCP server runs as a local process — no cloud middleman.

Zero Dependencies

Built on native Node.js fetch — no Axios, no HTTP libraries. Minimal, fast, and easy to audit.

8 Tools. Full ServiceNow Access.

Everything from simple lookups to complex aggregations — exposed as MCP tools that any AI assistant can call.

Query Records

Search any ServiceNow table with encoded queries, field selection, pagination, and sorting.

query_records

Get Record

Retrieve a single record by sys_id with optional field projection and display-value resolution.

get_record

Create Record

Insert new records into any table — incidents, tasks, catalog items, CIs — through natural language.

create_record

Update Record

Modify existing records by sys_id. Update fields, change states, reassign work conversationally.

update_record

Delete Record

Remove records from any table with confirmation safeguards for safe cleanup.

delete_record

Aggregate

Run COUNT, SUM, AVG, MIN, MAX aggregations with groupBy. Instant analytics from conversation.

aggregate_records

Table Schema

Inspect table structures — column names, types, references, and choices on the fly.

get_table_schema

Attach File

Upload and attach files to any record. Supports base64 for screenshots, CSVs, PDFs, and more.

attach_file

ServiceNow MCP FAQs

Quick answers for teams evaluating MCP as their ServiceNow AI integration layer.

Quick Start

Get connected in under a minute. No build step. No configuration files.

Run with npx (no install needed)

npx @onlyflows/servicenow-mcp

or install globally

npm install -g @onlyflows/servicenow-mcp

Add to your MCP client config

For Claude Desktop, add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "servicenow": {
      "command": "npx",
      "args": ["@onlyflows/servicenow-mcp"],
      "env": {
        "SN_INSTANCE": "your-instance.service-now.com",
        "SN_USERNAME": "your-username",
        "SN_PASSWORD": "your-pass"  // pragma: allowlist secret
      }
    }
  }
}

Start talking to ServiceNow

Restart your MCP client and start asking questions. The AI will automatically use the ServiceNow tools when relevant.

Works With Your Favorite AI Tools

MCP is a universal protocol. Any client that speaks MCP can use this server.

Claude Desktop

Anthropic's desktop app with native MCP support

Cursor

AI-powered code editor with MCP integration

VS Code

Via Copilot Chat MCP extensions

Any MCP Client

Standard protocol — works with any compliant client

Natural Language. Real Results.

No encoded queries. No API docs. Just describe what you need.

“Show me all P1 incidents assigned to the Network team opened this week”

Queries the incident table with priority=1, assignment_group=Network, and opened_at filters — returns formatted results.

“Create a change request for the Saturday maintenance window”

Creates a new change_request with pre-filled description, scheduled dates, and category fields.

“How many incidents per category were opened last month?”

Runs an aggregate COUNT grouped by category with date range filter — chart-ready data.

“What's the schema for cmdb_ci_server?”

Returns the full table schema including name, type, max_length, references, and choice values.

Built for Enterprise ServiceNow

Secure by Design

Credentials stay local. Uses ServiceNow's Table API with proper ACL enforcement. Your instance security model stays intact.

Zero HTTP Dependencies

Built on native Node.js fetch and the official MCP SDK. No Axios, no request libraries. Minimal attack surface, easy to audit.

Any Table, Any Record

Not limited to ITSM. Works with CMDB, ITOM, HR, CSM, custom apps — the entire ServiceNow platform.

Open Source & Community Driven

Free and open source under the MIT License. Built with the official MCP TypeScript SDK.

Report Issues

Found a bug or need a feature? Open an issue on GitHub.

Pull Requests

PRs welcome! Fork, branch from main, and submit.

Community

Share use cases and help shape the future of ServiceNow + AI.

Star on GitHub View on npm

Built by a ServiceNow CTA

Created by OnlyFlows — backed by a Certified Technical Architect with deep platform expertise. We build the tools that ServiceNow teams actually need.

Read the Blog Post

Connect Your AI to ServiceNow

One command. Any MCP client. Full platform access.

GitHub Repo

Need custom MCP servers or ServiceNow AI strategy? Contact OnlyFlows →