home / mcp / servicenow mcp server

ServiceNow MCP Server

Provides an MCP server that interfaces with ServiceNow to access and manipulate data via a secure API.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "michaelbuckner-servicenow-mcp": {
      "command": "python",
      "args": [
        "-m",
        "mcp_server_servicenow.cli",
        "--url",
        "https://your-instance.service-now.com/",
        "--username",
        "your-username",
        "--password",
        "your-password"
      ],
      "env": {
        "SERVICENOW_PASSWORD": "your-password",
        "SERVICENOW_USERNAME": "your-username",
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com/"
      }
    }
  }
}

You can run a ServiceNow MCP Server locally to access and manipulate ServiceNow data through a secure API. It lets you search for records, update them, manage incidents, users, knowledge articles, and more using natural language or explicit commands, making ServiceNow interactions fast and scriptable from your AI workflows.

How to use

Launch the MCP server from your development environment and connect your MCP client or agent to the local process. You can interact with a variety of ServiceNow resources such as incidents, users, knowledge articles, and tables. Use natural language tools to search for records or update them, and use explicit commands to perform actions like creating or updating an incident, adding comments or work notes, and updating scripts. The server communicates with your ServiceNow instance securely and returns results that your agent can act on.

How to install

Prerequisites: Python 3.8 or newer. A ServiceNow instance with API access.

pip install mcp-server-servicenow

git clone https://github.com/michaelbuckner/servicenow-mcp.git
cd servicenow-mcp
pip install -e .

python -m mcp_server_servicenow.cli --url "https://your-instance.service-now.com/" --username "your-username" --password "your-password"

Alternatively, you can run the server by setting environment variables and invoking the CLI without passing them on the command line.

Additional content

Configuration and usage details are provided below to help you run and connect the MCP server. You can also configure the server in your MCP client’s settings to point at the local CLI entry point using the command and arguments shown here.

Authentication and security

The server supports multiple authentication methods to suit your security requirements. Basic Authentication uses a username and password, Token Authentication relies on OAuth tokens, and OAuth Authentication uses a client ID, client secret, username, and password. Use the method that aligns with your ServiceNow instance and security policies.

Development and testing notes

Install dependencies, run tests with your preferred Python environment, and validate that commands and queries against your ServiceNow instance return the expected results. Use a virtual environment to keep dependencies isolated.

Available tools

list_incidents

List recent incidents from the ServiceNow incidents resource.

get_incident

Retrieve a specific incident by number or sys_id.

list_users

List users in the ServiceNow instance.

list_knowledge

List knowledge articles available in the knowledge base.

list_tables

List available tables and their schemas.

get_records

Fetch records from a specific table using criteria.

search_records

Search for records using a text query.

get_record

Get a specific record by its sys_id.

perform_query

Execute a query across ServiceNow data.

add_comment

Add a customer-visible comment to an incident.

add_work_notes

Add internal work notes to an incident.

natural_language_search

Search records using natural language queries.

natural_language_update

Update records using natural language commands.

update_script

Update ServiceNow script files such as script includes or business rules.