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
- Activate virtual environment
- Configure ServiceNow credentialsEdit
.env
file with your ServiceNow instance details: - Start the MCP serverYou 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: - 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 -19PythonMIT 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 -1PythonMIT 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 -6Python
- -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 -Python