Skip to content
MCP server

ServiceNow MCP Server

ServiceNow Table API, CMDB, schema and update set access for AI assistants

Runs locally
Install
Pricing
Open source
Platforms
CLI, Self-hosted
Runs
Locally
Version
0.9.3
Listing updated
5 days ago

Similar MCP servers

About ServiceNow MCP Server

ServiceNow MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Built around the developer side of ServiceNow, this server gives an assistant the Table API, the data dictionary, Stats API aggregates, the CMDB and update sets on releases from Tokyo onward. The README frames it as running alongside ServiceNow's own MCP servers rather than replacing them.

It ships 20 tools, 5 resources and 4 packaged skills. Which tools show up depends on the roles of the integration user: with the read-only role, only the 13 read tools are listed, and giving the user write roles adds 7 write tools. Authentication can be basic, OAuth or an API key, and settings such as a read-only mode, an audit log and a switch for JavaScript in queries are controlled by environment variables.

The setup guide walks through a free Personal Developer Instance and a dedicated integration user instead of the admin account. A --check flag runs read-only diagnostics and never prints secrets.

Install

Run in a terminal

claude mcp add mcp-server-servicenow --env SERVICENOW_INSTANCE_URL='<SERVICENOW_INSTANCE_URL>' --env SERVICENOW_PASSWORD='<SERVICENOW_PASSWORD>' --env SERVICENOW_CLIENT_SECRET='<SERVICENOW_CLIENT_SECRET>' --env SERVICENOW_API_KEY='<SERVICENOW_API_KEY>' -- uvx mcp-server-servicenow

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-servicenow": {
      "command": "uvx",
      "args": [
        "mcp-server-servicenow"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "<SERVICENOW_INSTANCE_URL>",
        "SERVICENOW_PASSWORD": "<SERVICENOW_PASSWORD>",
        "SERVICENOW_CLIENT_SECRET": "<SERVICENOW_CLIENT_SECRET>",
        "SERVICENOW_API_KEY": "<SERVICENOW_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-servicenow": {
      "command": "uvx",
      "args": [
        "mcp-server-servicenow"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "<SERVICENOW_INSTANCE_URL>",
        "SERVICENOW_PASSWORD": "<SERVICENOW_PASSWORD>",
        "SERVICENOW_CLIENT_SECRET": "<SERVICENOW_CLIENT_SECRET>",
        "SERVICENOW_API_KEY": "<SERVICENOW_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server-servicenow": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-servicenow"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "<SERVICENOW_INSTANCE_URL>",
        "SERVICENOW_PASSWORD": "<SERVICENOW_PASSWORD>",
        "SERVICENOW_CLIENT_SECRET": "<SERVICENOW_CLIENT_SECRET>",
        "SERVICENOW_API_KEY": "<SERVICENOW_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-servicenow": {
      "command": "uvx",
      "args": [
        "mcp-server-servicenow"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "<SERVICENOW_INSTANCE_URL>",
        "SERVICENOW_PASSWORD": "<SERVICENOW_PASSWORD>",
        "SERVICENOW_CLIENT_SECRET": "<SERVICENOW_CLIENT_SECRET>",
        "SERVICENOW_API_KEY": "<SERVICENOW_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server-servicenow": {
      "command": "uvx",
      "args": [
        "mcp-server-servicenow"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "<SERVICENOW_INSTANCE_URL>",
        "SERVICENOW_PASSWORD": "<SERVICENOW_PASSWORD>",
        "SERVICENOW_CLIENT_SECRET": "<SERVICENOW_CLIENT_SECRET>",
        "SERVICENOW_API_KEY": "<SERVICENOW_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SERVICENOW_INSTANCE_URLServiceNow instance URLRequired
  • SERVICENOW_AUTH_TYPEAuth type: basic (default), oauth, or api_key
  • SERVICENOW_USERNAMEUsername for basic auth or the OAuth password grant (omit for OAuth client credentials)
  • SERVICENOW_PASSWORDPassword for basic auth or the OAuth password grant (omit for OAuth client credentials)
  • SERVICENOW_CLIENT_IDOAuth client ID (client credentials grant unless a username and password are set)
  • SERVICENOW_CLIENT_SECRETOAuth client secret
  • SERVICENOW_API_KEYAPI key for api_key auth
  • SERVICENOW_API_KEY_HEADERHeader name for api_key auth (default x-sn-apikey, ServiceNow's default auth parameter)
  • SERVICENOW_TOKEN_URLOAuth token URL (default <instance>/oauth_token.do)
  • SERVICENOW_TIMEOUTHTTP timeout in seconds (default 30)
  • SERVICENOW_DEBUGDebug logging (default false)
  • SERVICENOW_READ_ONLYHide write tools and refuse non-GET requests
  • SERVICENOW_ALLOW_JS_QUERIESPermit arbitrary javascript: in caller queries
  • SERVICENOW_AUDIT_LOGAudit log target: stderr (default), off, or a file path
  • SERVICENOW_SKILLSon (default) or off: serve the packaged skill:// resources

What it does

Table API access
Query any ServiceNow table, including custom ones.
Schema and CMDB reads
Inspect fields with inherited ones and check configuration item data.
Update set review
Review an update set before promoting it.
Aggregate queries
Count records by group, for example open incidents per assignment group.
Read-only mode
An environment switch hides write tools and refuses non-GET requests.
Audit log
Writes an audit trail to stderr, off, or a file path.

Good for

  • Ask which fields a CMDB table has, including inherited ones
  • Find server CIs missing an IP address or owner
  • Review an update set before promotion
  • Audit who holds admin and how roles were granted
  • Count open incidents by assignment group

Pricing

Open source

Free, MIT licensed; works on a free ServiceNow developer instance.

ServiceNow MCP Server FAQ

Which ServiceNow versions work?

The README says any release from Tokyo up.

Can it change data?

Only if the integration user has write roles; with the snc_read_only role just the 13 read tools are exposed.

How is it installed?

Run it with uvx mcp-server-servicenow or add the Claude Code plugin; the package is on PyPI.

What authentication does it support?

Basic, OAuth and API key, chosen with SERVICENOW_AUTH_TYPE.

What licence is it under?

MIT.

Is ServiceNow MCP Server free?

Yes. ServiceNow MCP Server is open source, so you can use and self-host it for free.

How do I add ServiceNow MCP Server to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-servicenow --env SERVICENOW_INSTANCE_URL='<SERVICENOW_INSTANCE_URL>' --env SERVICENOW_PASSWORD='<SERVICENOW_PASSWORD>' --env SERVICENOW_CLIENT_SECRET='<SERVICENOW_CLIENT_SECRET>' --env SERVICENOW_API_KEY='<SERVICENOW_API_KEY>' -- uvx mcp-server-servicenow

What are the best alternatives to ServiceNow MCP Server?

The closest alternatives to ServiceNow MCP Server are Happy Platform MCP, Servicenow MCP Ai, OnlyFlows ServiceNow MCP, AboutTheApp and Monday Com.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers