Skip to main content
Glama
hunterphillips

sn-mcp

by hunterphillips
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

sn-mcp

MCP server that gives AI coding assistants read access to a ServiceNow instance — useful when building or debugging ServiceNow apps.

Prerequisites

  • uv — Python package manager

  • A ServiceNow instance with a user that has read access to sys_dictionary and any tables you want to query

Related MCP server: ServiceNow MCP Server

Setup

git clone <this-repo>
cd sn-mcp
cp .env.example .env

Edit .env with your instance details:

SN_INSTANCE=https://yourinstance.service-now.com
SN_USERNAME=your_username
SN_PASSWORD=your_password

Adding to Claude

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "sn-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/sn-mcp", "sn-mcp"],
      "env": {
        "SN_INSTANCE": "https://yourinstance.service-now.com",
        "SN_USERNAME": "your_username",
        "SN_PASSWORD": "your_password"
      }
    }
  }
}

You can use either the env block above or a .env file in the repo directory — whichever you prefer.

Claude Code (CLI)

claude mcp add sn-mcp -- uv run --directory /absolute/path/to/sn-mcp sn-mcp

Then set credentials in .env or pass them via the env block in .mcp.json.

Tools

Tool

Description

get_table_schema(table, filter_keyword?)

Field definitions for any table from sys_dictionary — type, label, mandatory, max_length, reference

query_table(table, query?, fields?, limit?)

Query any table with an encoded query string (e.g. state=1^category=network)

get_record(table, sys_id)

Fetch a single record by sys_id from any table

Verify it's working

uv run python server.py

Or test the MCP handshake directly:

python3 -c "
import subprocess, json, select
proc = subprocess.Popen(['uv','run','python','server.py'], stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
def send(msg):
    proc.stdin.write((json.dumps(msg)+'\n').encode()); proc.stdin.flush()
    ready,_,_ = select.select([proc.stdout],[],[],5)
    return json.loads(proc.stdout.readline()) if ready else None
r = send({'jsonrpc':'2.0','id':1,'method':'initialize','params':{'protocolVersion':'2024-11-05','capabilities':{},'clientInfo':{'name':'test','version':'0'}}})
print('server:', r['result']['serverInfo'])
proc.terminate()
"

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • Dataassist-IOOAuth
    io.github.DataAssistIO

    Query your org's data in natural language — read-only MCP access to SQL, NoSQL, files & warehouses.

    SearchDatabases
    2
  • Market BrewC
    ai.marketbrew

    AI Visibility Isn’t Luck. It’s Signal Alignment. Read-only MCP access to Market Brew, a patented search engineering platform for SEO and AI visibility. Market Brew uses particle swarm optimization and template models to reverse engineer observed search behavior. Inspect ranking models, content alignment, knowledge bases, crawl data, and AI visibility history through a hosted Streamable HTTP MCP server. Requires an enabled Market Brew account and OAuth. Setup guide: https://brew.marketbrew.ai/customer-manual.htm#api-and-chatgpt-read-access

    MarketingSearch
    701
  • HAVNOAuth
    app.havnre

    Read-only AI access to HAVN properties, leads, tasks, files, media, and analytics.

    Real EstateCRM
    2
  • Reality Graph Verification ToolsA
    dev.realitygraph

    Read-only AI coding tools for change verification, release readiness, capacity, and guidance.

    Code AnalysisDeveloper ToolsSearch
    102

Related MCP Servers