servicenow

This MCP server provides a structured interface to the ServiceNow REST APIs, exposing a suite of tools for incident management, change management, CMDB queries, service catalog interactions, knowledge base lookups, and user management. Clients can send JSON-encoded tool requests (e.g., incident_create, query_table, ci_search) to the server and receive standardized JSON responses. The server is designed to be used behind MCP clients like Claude Desktop, VS Code, or Cursor, enabling automated workflows and AI-assisted operations against a ServiceNow instance. Start the server with the python -m servicenow_mcp_server command (the entry point exposed by the package) and configure the connection details via environment variables or a config file as described in the README. Tools are grouped by capability (Table Operations, Incident Management, Change Management, CMDB, User Management, Knowledge Base, Service Catalog, Analytics). Typical usage involves authenticating with a ServiceNow user that has API access, then invoking a tool with the required arguments to perform create, read, update, or delete actions, or to search and retrieve data.

Example workflows include:

• Creating an incident via incident_create with a short_description, description, urgency, and assignment_group.
• Querying CMDB items using ci_search to filter by name, class, and operational status.
• Listing catalog items with catalog_items and processing the returned catalog data in your automation pipeline. The server handles common MCP chores such as authentication, error reporting, and structured responses, enabling seamless integration with client-side assistants and automation scripts.

Prerequisites:\n- Python 3.9 or higher installed on your system.\n- Network access to the ServiceNow instance.\n- A ServiceNow user with API access credentials.\n\nInstallation from source:\nbash\n# Clone the repository\ngit clone https://github.com/asklokesh/servicenow-mcp-server.git\ncd servicenow-mcp-server\n\n# Create and activate a virtual environment\npython -m venv venv\nsource venv/bin/activate # On Windows: venv\\Scripts\\activate\n\n# Install in editable mode (development mode)\npip install -e .\n\n\nOptionally, installation from PyPI (if available):\nbash\npip install servicenow-mcp-server\n\n\nConfigure environment variables (see .env.example or configuration docs):\nbash\nexport SERVICENOW_INSTANCE=your-instance.service-now.com\nexport SERVICENOW_USERNAME=your-username\nexport SERVICENOW_PASSWORD=your-password\n\n\nRun the MCP server:\nbash\npython -m servicenow_mcp_server\n# or if installed as a console script via the entry point:\nservicenow-mcp\n

Environment variables are preferred for sensitive credentials. Consider enabling OAuth or secret management in production. If you run into authentication issues, verify that the ServiceNow instance URL does not require a trailing scheme or port unless necessary. For debugging, you can enable verbose logs in the MCP client or set MCP_LOG_LEVEL in the environment. The server supports multiple configuration methods (environment variables, config/local.json, config/default.json) with precedence rules; ensure credentials are securely provided in the selected method. When using CLI clients, supply either env vars or a config directory as described in the Integration section of the README to ensure all tools can authenticate correctly.