ServiceNow MCP Server

by Vel-12

333 downloads

Not rated

GitHub

Other

Description

[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/osomai-servicenow-mcp-badge.png)](https://mseep.ai/app/osomai-servicenow-mcp) # ServiceNow MCP Server A Model Completion Protocol (MCP) server implementation for ServiceNow, allowing Claude to interact with ServiceNow…

About

Details

Author: Vel-12
Downloads: 333
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name ServiceNow MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

From the repository

Install with Python 3.11+, clone the repository, create a virtual environment, install the package, and configure a .env file with ServiceNow credentials. Start the server with python -m servicenow_mcp.cli for stdio mode or servicenow-mcp-sse for SSE mode. Optionally set the MCP_TOOL_PACKAGE environment variable to load a subset of tools. Integration with Claude Desktop is configured via a JSON file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "servicenow mcp server": {
            "ServiceNow": {
                "command": "python",
                "args": [
                    "-m",
                    "servicenow_mcp.cli"
                ],
                "env": {
                    "SERVICENOW_INSTANCE_URL": "",
                    "SERVICENOW_USERNAME": "",
                    "SERVICENOW_PASSWORD": "",
                    "SERVICENOW_AUTH_TYPE": ""
                }
            }
        }
    }
}

McpServers

{
    "ServiceNow": {
        "command": "python",
        "args": [
            "-m",
            "servicenow_mcp.cli"
        ],
        "env": {
            "SERVICENOW_INSTANCE_URL": "",
            "SERVICENOW_USERNAME": "",
            "SERVICENOW_PASSWORD": "",
            "SERVICENOW_AUTH_TYPE": ""
        }
    }
}

ServiceNow MCP Server

A Model Completion Protocol (MCP) server implementation for ServiceNow, allowing Claude to interact with ServiceNow instances.

Overview

This project implements an MCP server that enables Claude to connect to ServiceNow instances, retrieve data, and perform actions through the ServiceNow API. It serves as a bridge between Claude and ServiceNow, allowing for seamless integration.

Features

- Connect to ServiceNow instances using various authentication methods (Basic, OAuth, API Key)
- Query ServiceNow records and tables
- Create, update, and delete ServiceNow records
- Execute ServiceNow scripts and workflows
- Access and query the ServiceNow Service Catalog
- Analyze and optimize the ServiceNow Service Catalog
- Debug mode for troubleshooting
- Support for both stdio and Server-Sent Events (SSE) communication

Installation

Prerequisites

- Python 3.11 or higher
- A ServiceNow instance with appropriate access credentials

Setup

1. Clone this repository:

   git clone https://github.com/yourusername/servicenow-mcp.git

   cd servicenow-mcp

2. Create a virtual environment and install the package:

   python -m venv .venv

   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

   pip install -e .

3. Create a .env file with your ServiceNow credentials:

   SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com

   SERVICENOW_USERNAME=your-username

   SERVICENOW_PASSWORD=your-password

   SERVICENOW_AUTH_TYPE=basic  # or oauth, api_key

Usage

Standard (stdio) Mode

To start the MCP server:

python -m servicenow_mcp.cli

Or with environment variables:

SERVICENOW_INSTANCE_URL=https://your-instance.service-now.com SERVICENOW_USERNAME=your-username SERVICENOW_PASSWORD=your-password SERVICENOW_AUTH_TYPE=basic python -m servicenow_mcp.cli

Server-Sent Events (SSE) Mode

The ServiceNow MCP server can also run as a web server using Server-Sent Events (SSE) for communication, which allows for more flexible integration options.

Starting the SSE Server

You can start the SSE server using the provided CLI:

servicenow-mcp-sse --instance-url=https://your-instance.service-now.com --username=your-username --password=your-password

By default, the server will listen on 0.0.0.0:8080. You can customize the host and port:

servicenow-mcp-sse --host=127.0.0.1 --port=8000

Connecting to the SSE Server

The SSE server exposes two main endpoints:

- /sse - The SSE connection endpoint
- /messages/ - The endpoint for sending messages to the server

Example

See the examples/sse_server_example.py file for a complete example of setting up and running the SSE server.

```python
from servicenow_mcp.server import ServiceNowMCP
from servicenow_mcp.server_sse import create_starlette_app
from servicenow_mcp.utils.config import ServerConfig, AuthConfig, AuthType, BasicAuthConfig
import uvicorn

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

ServiceNow MCP Server

Overview

Features

Installation

Prerequisites

Setup

Usage

Standard (stdio) Mode

Server-Sent Events (SSE) Mode

Starting the SSE Server

Connecting to the SSE Server

Example

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀