servicenow-agent

What This Skill Does

The servicenow-agent provides a secure, read-only interface for interacting with your ServiceNow instance. It acts as a specialized CLI bridge that facilitates data retrieval across Table, Attachment, Aggregate, and Service Catalog APIs. By adhering strictly to GET-only operations, this skill ensures that your production environment remains protected from unintended data modifications, deletions, or updates. It is designed to empower AI agents with the ability to query incident history, inspect table schemas, analyze aggregate statistics, and retrieve documentation from the Service Catalog, all while maintaining strict adherence to your configured environment variables.

Installation

To begin using the skill, ensure your OpenClaw environment is properly configured. Run the following command in your terminal to integrate the skill into your project:

clawhub install openclaw/skills/skills/thesethrose/servicenow-agent

Once installed, navigate to the skill's directory and configure your .env file with the required SERVICENOW_DOMAIN, SERVICENOW_USERNAME, and SERVICENOW_PASSWORD keys. These credentials allow the CLI to communicate with your instance. The skill is built to automatically detect these credentials, ensuring a seamless setup process for immediate query execution.

Use Cases

This skill is perfect for IT support automation, ITSM data analysis, and technical troubleshooting. Common scenarios include:

• Incident Triage: Quickly fetching the history of a specific ticket to view work notes and comments without leaving the AI interface.
• Schema Inspection: Developers can inspect table structures to identify available fields before running data analysis.
• Operational Reporting: Using the Aggregate API to run statistics on record counts or field averages across groups.
• Catalog Discovery: Browsing the Service Catalog to identify available items or templates for end-user documentation.

Example Prompts

1. "List the last 5 open incidents assigned to the 'Network' group and show the priority and short description."
2. "Get the full history and work note timeline for incident SYS_ID_12345."
3. "Show me the aggregate count of all closed incidents grouped by the assignment group for this month."

Tips & Limitations

• Safety First: This tool is strictly read-only. Attempts to perform write operations via custom scripts will fail as the underlying logic strictly limits interactions to GET methods.
• Performance: When performing large queries, always utilize the --sysparm_limit flag to keep API responses manageable and prevent timeout issues.
• Formatting: Use the --pretty flag to output human-readable JSON, which is particularly useful when piping outputs into other data processing tools or displaying results in an agent UI.
• Documentation: For complex queries involving encoded strings, consult the official ServiceNow REST API documentation, as the sysparm_query syntax adheres to standard ServiceNow query string formatting.