ServiceNow CMDB

You deploy and run an MCP server that lets you query ServiceNow CMDB tables from an MCP client. It exposes a tool you can call to fetch table data, with optional field selection and filtering, enabling you to power data-driven workflows and integrations.

How to use

You connect your MCP client to the ServiceNow CMDB MCP Server to access table data. Start the server, then configure your MCP client to point at the local MCP URL. Once connected, you can use the get_cmdb_table_data tool to retrieve records from any CMDB table, optionally selecting fields and applying filters to narrow results.

Practical usage patterns include: fetching all records from a specific CMDB table, selecting only the fields you need, and applying a query to filter results (for example, by operational status). You can combine table_name, fields, and query to tailor the data you receive.

How to install

Prerequisites you need before starting:

• Python 3.11+

• Node.js and npm for MCP client integration (if you plan to connect via an MCP client that uses npx)

• ServiceNow instance with API access and valid credentials

Follow these concrete steps to install and run the server locally:

cd "ServiceNow CMDB MCP" 

# Activate the Python virtual environment
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Prepare ServiceNow credentials
cp .env.template .env

# Edit .env with your ServiceNow details:
# SERVICENOW_URL=https://your-instance.service-now.com
# SERVICENOW_USER=your-username
# SERVICENOW_PASS=your-password

# Start the MCP server
python server.py

# Expected log output indicates the server started and is listening on http://127.0.0.1:9123

Additional notes

Configuration and runtime behavior: The server runs locally and exposes an HTTP MCP endpoint at http://127.0.0.1:9123/mcp/ by default. You can also connect a client by registering an MCP server configuration that points to this local URL.

Configuration and runtime details

You can configure your MCP client (for example, a client named ServiceNowCMDB) to connect to the local MCP server. The following configuration demonstrates how to expose the server as an MCP endpoint for a client, using an HTTP-based MCP connection.

Security and environment

Store ServiceNow credentials securely in the environment file and ensure the .env file is protected. Use strong, unique credentials for the ServiceNow API access and restrict access to the MCP server interface as needed.

Usage examples with the built-in tool

Get all computers from CMDB by querying the cmdb_ci_computer table.

Get specific fields by selecting name, serial_number, and manufacturer from the cmdb_ci_computer table.

Filter results to operational items by applying the query operational_status=1 on the cmdb_ci_computer table.

Available tools

get_cmdb_table_data

Query any CMDB table with optional filtering, field selection, and pagination by specifying table_name, query, fields, limit, and offset.