ServiceNow CMDB MCP Server
A Model Context Protocol (MCP) server for interacting with ServiceNow CMDB (Configuration Management Database) tables.
Features
Tool:
get_cmdb_table_data
- Query any CMDB table with filtering, field selection, and pagination
Installation for Claude
Step 1: Setup the Server
Navigate to the project directory
cd "ServiceNow CMDB MCP"Activate virtual environment
source venv/bin/activate # On Windows: venv\Scripts\activateConfigure ServiceNow credentials
cp .env.template .envEdit
.env
file with your ServiceNow instance details:SERVICENOW_URL=https://your-instance.service-now.com SERVICENOW_USER=your-username SERVICENOW_PASS=your-passwordStart the MCP server
python server.pyYou should see:
INFO: Started server process
andINFO: Uvicorn running on http://127.0.0.1:9123
Step 2: Configure Claude
Open Claude settings (gear icon in bottom left)
Navigate to MCP section
Add the following configuration to your
mcpServers
section:"mcpServers": { "ServiceNowCMDB": { "command": "npx", "args": ["mcp-remote", "http://localhost:9123/mcp/"] } }Save and restart Claude
Step 3: Verify Installation
Once Claude restarts, you should see:
A new "ServiceNowCMDB" server in your MCP servers list
Access to the
get_cmdb_table_data
tool
Prerequisites
Python 3.11+
Node.js and npm (for
npx
command)ServiceNow instance with API access
Valid ServiceNow credentials
Usage in Claude
After setup, you can use the tool in Claude:
API Endpoints
The server runs on http://127.0.0.1:9123
by default.
Tools
get_cmdb_table_data
Query any CMDB table with optional filtering and field selection.
Parameters:
table_name
(required): Name of the CMDB tablequery
(optional): ServiceNow query string for filteringfields
(optional): Comma-separated list of fields to returnlimit
(optional): Maximum number of records (default: 100)offset
(optional): Number of records to skip (default: 0)
Usage Examples
Get all computers
Get specific fields
Filter by status
Common CMDB Tables
cmdb_ci_computer
- Computer configuration itemscmdb_ci_server
- Server configuration itemscmdb_ci_network_gear
- Network equipmentcmdb_ci_storage_device
- Storage devicescmdb_ci_database
- Database configuration items
Error Handling
The server includes comprehensive error handling for:
Missing credentials
HTTP errors from ServiceNow
Invalid JSON responses
Network timeouts
License
MIT License
This server cannot be installed
Enables interaction with ServiceNow CMDB tables through a Model Context Protocol server, allowing users to query any CMDB table with filtering, field selection, and pagination capabilities.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.Last updated -24MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants and development tools to interact with ServiceNow instances, providing comprehensive API coverage for incident management, change management, CMDB, and other ServiceNow modules.Last updated -1MIT License
- -securityFlicense-qualityA Model Context Protocol server that provides comprehensive access to Microsoft SQL Server databases, enabling Language Models to inspect schemas, execute queries, manage database objects, and perform advanced database operations.Last updated -7
- -securityFlicense-qualityA Model Context Protocol server for integrating with ServiceDesk Plus On-Premise that provides comprehensive CMDB functionality, allowing users to manage tickets, assets, software licenses, contracts, vendors, and administrative settings through natural language.Last updated -