Servicenow

🚀 ServiceNow MCP Server

A Model Context Protocol (MCP) server integrated with ServiceNow, enabling AI agents to access and manipulate ServiceNow data via a secure API. This server supports natural language interaction with ServiceNow, simplifying tasks such as searching records, updating data, and managing scripts.

🚀 Quick Start

The ServiceNow MCP Server allows AI agents to interact with ServiceNow data through secure APIs, supporting natural - language operations.

✨ Features

Resources

• servicenow://incidents: List recent incident tickets.
• servicenow://incidents/{number}: Retrieve a specific incident ticket by its number.
• servicenow://users: List user information.
• servicenow://knowledge: List knowledge base articles.
• servicenow://tables: Display available tables.
• servicenow://tables/{table}: Fetch records from a specified table.
• servicenow://schema/{table}: Obtain schema information for a table.

Tools

Basic Tools

• create_incident: Create a new incident ticket.
• update_incident: Update an existing incident ticket.
• search_records: Search for records using a text query.
• get_record: Retrieve a specific record by its sys_id.
• perform_query: Execute a ServiceNow query.
• add_comment: Add a customer - visible comment (visible only to customers).
• add_work_notes: Add internal work notes.

Natural Language Tools

• natural_language_search: Search for records using natural language (e.g., Find all incident tickets about emails).
• natural_language_update: Update records using natural language (e.g., Update incident ticket INC0010001 to "In Progress").
• update_script: Update ServiceNow script files (script includes, business rules, etc.).

📦 Installation

Install from PyPI

pip install mcp-server-servicenow

Install from Source

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

💻 Usage Examples

Basic Usage

Run via Command Line

Start the server using the Python module:

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

Use a Configuration File

Create a configuration file config.json with the following content:

{
    "instance_url": "https://your-instance.service-now.com/",
    "username": "admin",
    "password": "admin"
}

Then run:

python -m mcp_server_servicenow.cli --config config.json

🔧 Technical Details

Install Development Dependencies

pip install -e ".[dev]"

Run Tests

pytest

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/amazing-feature).
3. Commit your changes (git commit -m 'Add some amazing feature').
4. Push to the branch (git push origin feature/amazing-feature).
5. Submit a Pull Request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.