ServiceNow MCP Server

A Model Context Protocol (MCP) server that interfaces with ServiceNow, allowing AI agents to access and manipulate ServiceNow data through a secure API. This server enables natural language interactions with ServiceNow, making it easier to search for records, update them, and manage scripts.

- servicenow://incidents: List recent incidents
- servicenow://incidents/{number}: Get a specific incident by number
- servicenow://users: List users
- servicenow://knowledge: List knowledge articles
- servicenow://tables: List available tables
- servicenow://tables/{table}: Get records from a specific table
- servicenow://schema/{table}: Get the schema for a table

- create_incident: Create a new incident
- update_incident: Update an existing incident
- search_records: Search for records using text query
- get_record: Get a specific record by sys_id
- perform_query: Perform a query against ServiceNow
- add_comment: Add a comment to an incident (customer visible)
- add_work_notes: Add work notes to an incident (internal)

- natural_language_search: Search for records using natural language (e.g., "find all incidents about SAP")
- natural_language_update: Update records using natural language (e.g., "Update incident INC0010001 saying I'm working on it")
- update_script: Update ServiceNow script files (script includes, business rules, etc.)

git clone https://github.com/michaelbuckner/servicenow-mcp.git cd servicenow-mcp pip install -e .

python -m mcp_server_servicenow.cli --url "https://your-instance.service-now.com/" --username "your-username" --password "your-password"

export SERVICENOW_INSTANCE_URL="https://your-instance.service-now.com/" export SERVICENOW_USERNAME="your-username" export SERVICENOW_PASSWORD="your-password" python -m mcp_server_servicenow.cli

To use this MCP server with Cline, add the following to your MCP settings file:

{ "mcpServers": { "servicenow": { "command": "/path/to/your/python/executable", "args": [ "-m", "mcp_server_servicenow.cli", "--url", "https://your-instance.service-now.com/", "--username", "your-username", "--password", "your-password" ], "disabled": false, "autoApprove": [] } } }

Note:Make sure to use the full path to the Python executable that has themcp-server-servicenowpackage installed.

You can search for records using natural language queries:

find all incidents about email search for incidents related to network issues show me all incidents with high priority

You can update records using natural language commands:

Update incident INC0010001 saying I'm working on it Set incident INC0010002 to in progress Close incident INC0010003 with resolution: fixed the issue

You can update ServiceNow scripts from local files:

Update the ServiceNow script include "HelloWorld" with the contents of hello_world.js Upload utils.js to ServiceNow as a script include named "UtilityFunctions" Update @form_validation.js, it's a client script called "FormValidation"

The server supports multiple authentication methods:
- Basic Authentication: Username and password
- Token Authentication: OAuth token
- OAuth Authentication: Client ID, Client Secret, Username, and Password

- Python 3.8+
- ServiceNow instance with API access

# Clone the repository git clone https://github.com/michaelbuckner/servicenow-mcp.git cd servicenow-mcp # Create a virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install development dependencies pip install -e ".[dev]"

Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

This project is licensed under the MIT License - see theLICENSEfile for details.

Expose the entire ArgoCD API to LLMs via MCP using just 2 auto-generated tools powered by the OpenAPI spec.