NowAIKit
About
The most comprehensive ServiceNow MCP server — 400+ tools across 35+ modules including ITSM, ITOM, CMDB, HRSD, CSM, SecOps, GRC, Flow Designer, Service Catalog, UI Builder, and Performance Analytics. Features 26 AI capabilities (scan, review, build, ops, docs), SDK mode, Direct
Details
- Author
- aartiq
- Downloads
- 232
- Categories
- Cloud Service, AI, Automation, Other, API, Developer Tools
Jump to
- Connects to any MCP-compatible AI platform out of the box
- 400+ production-ready tools covering every ServiceNow module
- Role-based tool packages for 14+ persona profiles
- Five-tier permission system (Read, Write, CMDB, Scripting, Now Assist)
- Multi-instance and multi-customer support from a single session
- 5-minute setup with no ServiceNow API knowledge required
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
NowAIKitCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Set up NowAIKit in under 5 minutes by connecting an MCP client (e.g., Claude Desktop, Cursor) to a ServiceNow instance using Basic Auth or OAuth 2.0. Configure environment variables for authentication (SERVICENOW_INSTANCE_URL, SERVICENOW_USERNAME, SERVICENOW_PASSWORD or OAuth credentials). Optionally set permissions via environment variables like WRITE_ENABLED, SCRIPTING_ENABLED, and select a tool package via MCP_TOOL_PACKAGE (e.g., service_desk, platform_developer, full). Then ask your AI in plain English to interact with ServiceNow.
search_tools
Search the full NowAIKit tool catalog (400+ tools) by keyword to discover the right tool without loading every definition. Returns matching tool names + descriptions ranked by relevance. Use this FIRST when you are unsure which tool to call. Especially useful with MCP_TOOL_DISCOVERY=lean, which exposes only a small core set plus this search.
query_records
Query ServiceNow records with filtering, field selection, pagination, and sorting
get_table_schema
Get the structure and field information for a ServiceNow table
get_record
Retrieve complete details of a specific record by sys_id
create_record
Create a new record in any ServiceNow table (requires WRITE_ENABLED=true). Pass dry_run=true to preview the resolved payload without writing.
update_record
Update an existing record in any ServiceNow table (requires WRITE_ENABLED=true). Pass dry_run=true to preview a before→after field diff without writing.
delete_record
Delete a record from any ServiceNow table (requires WRITE_ENABLED=true). Pass dry_run=true to preview the record that would be deleted without deleting it.
validate_query
Lint-check a ServiceNow encoded query BEFORE running it: validates javascript: expressions against the safe function allowlist, length limits, and common mistakes (e.g. using = instead of ^, raw spaces). Returns { valid, issues, suggestions }.
get_user
Look up user details by email or username
get_group
Find assignment group details by name or sys_id
search_cmdb_ci
Search for configuration items (CIs) in the CMDB
get_cmdb_ci
Get complete information about a specific configuration item
list_relationships
Show parent and child relationships for a CI
list_discovery_schedules
List discovery schedules and their run status
list_mid_servers
List MID servers and verify they are healthy
list_active_events
Monitor critical infrastructure events
cmdb_health_dashboard
Get CMDB data quality metrics (completeness of server and network CI data)
service_mapping_summary
View service dependencies and related CIs for impact analysis
natural_language_search
Search ServiceNow using plain English
natural_language_update
Update a record using natural language (requires WRITE_ENABLED=true)
list_instances
List all configured ServiceNow instances (multi-instance / multi-customer support)
switch_instance
Switch the active ServiceNow instance for this session
get_current_instance
Get the currently active ServiceNow instance name and URL
create_ci_relationship
[Write] Create a relationship between two CMDB Configuration Items
cmdb_impact_analysis
Analyze the downstream impact of a Configuration Item change or outage
run_discovery_scan
[Write] Trigger a ServiceNow Discovery scan for network/infrastructure
bulk_create_records
Create many records in one table in a single call, tracking every created sys_id and returning a rollback_token. With rollback_on_error=true, a mid-way failure deletes everything already created so the batch is all-or-nothing. Supports dry_run. Requires WRITE_ENABLED=true.
rollback_changes
Delete a set of previously-created records, e.g. the rollback_token returned by bulk_create_records. Requires WRITE_ENABLED=true.
compare_instances
Compare two configured ServiceNow instances: record counts for a table (with optional query) and/or a specific system property value. Useful for dev→prod drift detection and governance.
create_incident
Create a new incident record (requires WRITE_ENABLED=true)
get_incident
Get full details of an incident by number (e.g. INC0012345) or sys_id
update_incident
Update fields on an existing incident (requires WRITE_ENABLED=true)
resolve_incident
Resolve an incident with resolution code and notes (requires WRITE_ENABLED=true)
close_incident
Close a resolved incident (requires WRITE_ENABLED=true)
add_work_note
Add an internal work note to any ITSM record (requires WRITE_ENABLED=true)
add_comment
Add a customer-visible comment to any ITSM record (requires WRITE_ENABLED=true)
create_problem
Create a new problem record (requires WRITE_ENABLED=true)
get_problem
Get full details of a problem by number (PRB...) or sys_id
update_problem
Update fields on an existing problem (requires WRITE_ENABLED=true)
resolve_problem
Resolve a problem with root cause and resolution notes (requires WRITE_ENABLED=true)
create_change_request
Create a new change request (requires WRITE_ENABLED=true)
get_change_request
Get full details of a change request by number (CHG...) or sys_id
update_change_request
Update fields on a change request (requires WRITE_ENABLED=true)
list_change_requests
List change requests with optional filtering by state or query
submit_change_for_approval
Move a change request to "Requested" state for approval (requires WRITE_ENABLED=true)
close_change_request
Close a change request with close code and notes (requires WRITE_ENABLED=true)
schedule_cab_meeting
[Write] Schedule a Change Advisory Board (CAB) meeting
get_task
Get details of any task record by number or sys_id
update_task
Update fields on a task record (requires WRITE_ENABLED=true)
list_my_tasks
List tasks assigned to the currently configured user
complete_task
Mark a task as complete (requires WRITE_ENABLED=true)
list_knowledge_bases
List all knowledge bases available in the instance
search_knowledge
Search knowledge base articles by keyword
get_knowledge_article
Get the full content of a knowledge article by number (KB...) or sys_id
create_knowledge_article
Create a new knowledge article (requires WRITE_ENABLED=true)
update_knowledge_article
Update a knowledge article (requires WRITE_ENABLED=true)
publish_knowledge_article
Publish a draft knowledge article (requires WRITE_ENABLED=true)
retire_knowledge_article
[Write] Retire a knowledge article (mark as outdated)
list_catalog_items
List available service catalog items
search_catalog
Search the service catalog for items matching a keyword
get_catalog_item
Get full details of a catalog item including its variables
create_catalog_item
Create a new service catalog item (requires WRITE_ENABLED=true)
update_catalog_item
Update an existing catalog item (requires WRITE_ENABLED=true)
order_catalog_item
Order a service catalog item (requires WRITE_ENABLED=true)
create_approval_rule
Create an approval rule that automatically generates approval requests when a record matches given conditions (requires WRITE_ENABLED=true). Uses the sysapproval_rule table.
get_my_approvals
List approvals pending for the currently configured user
list_approvals
List approval requests with optional filters
approve_request
Approve a pending approval request (requires WRITE_ENABLED=true)
reject_request
Reject a pending approval request (requires WRITE_ENABLED=true)
get_sla_details
Get SLA breach status for a specific task or incident
list_active_slas
List active SLA records with optional filters
create_catalog_variable
[Write] Add a form variable to a service catalog item
create_catalog_ui_policy
[Write] Create a UI policy for a catalog item form
list_users
List users with optional search filter
create_user
Create a new user account (requires WRITE_ENABLED=true)
update_user
Update a user account (requires WRITE_ENABLED=true)
list_groups
List groups with optional search filter
create_group
Create a new assignment group (requires WRITE_ENABLED=true)
update_group
Update a group (requires WRITE_ENABLED=true)
add_user_to_group
Add a user to a group (requires WRITE_ENABLED=true)
remove_user_from_group
Remove a user from a group (requires WRITE_ENABLED=true)
list_reports
List saved reports in the instance (latest release: /api/now/reporting)
get_report
Get the definition and metadata of a saved report
run_aggregate_query
Run a grouped aggregate (COUNT, SUM, AVG) query on any table (latest release: /api/now/stats/{table})
trend_query
Get time-bucketed trend data for a table (useful for monthly/weekly trend charts)
get_performance_analytics
Read Performance Analytics scorecard/indicator data (requires PA plugin; GET /api/now/pa/scorecards). Pass an indicator sys_id, or a PA widget sys_id to resolve its indicator.
export_report_data
Export raw table data as structured JSON for use in external reports
get_sys_log
Retrieve system log entries for debugging or auditing. Set app_scope=true to read the scoped-application log (syslog_app_scope), where scoped gs.info()/gs.log() output lands, instead of the global syslog.
list_scheduled_jobs
List scheduled jobs and their run schedules
get_scheduled_job
Get full details of a scheduled job by sys_id or name
create_scheduled_job
Create a new scheduled script execution job (requires WRITE_ENABLED=true)
update_scheduled_job
Update a scheduled job (requires WRITE_ENABLED=true)
trigger_scheduled_job
Immediately execute a scheduled job on-demand (requires WRITE_ENABLED=true)
create_report
Create a new saved report on any table (requires WRITE_ENABLED=true)
update_report
Update an existing saved report definition (requires WRITE_ENABLED=true)
list_job_run_history
List recent run history for scheduled jobs (success/failure log)
create_scheduled_report
[Write] Schedule a report for recurring email delivery
create_kpi
[Write] Create a Key Performance Indicator from ServiceNow data
generate_report
Generate a branded PDF or PPTX report from capability analysis results. Call this after completing a scan, review, or audit to create a management-ready document with charts, tables, and ServiceNow links. Supports single capability (content) or multiple capabilities (sections) in one combined report.
list_atf_suites
List ATF test suites in the instance
get_atf_suite
Get details of a test suite including test count
run_atf_suite
Execute an ATF test suite (requires ATF_ENABLED=true)
list_atf_tests
List ATF test cases, optionally filtered by suite
get_atf_test
Get details of a specific test case
run_atf_test
Execute a single ATF test (requires ATF_ENABLED=true)
get_atf_suite_result
Get the results of a test suite run
list_atf_test_results
List individual test results within a suite run
get_atf_failure_insight
Get ATF Failure Insight data — metadata changes between last successful and failed run (role changes, field value changes)
nlq_query
Ask a natural language question and get structured ServiceNow data (ServiceNow NLQ API)
ai_search
Semantic AI-powered search across KB, catalog, incidents (ServiceNow AI Search)
categorize_incident
Suggest category, assignment group, and priority for an incident by analysing similar resolved incidents (Table API). Predictive Intelligence has no public REST prediction endpoint; for model-based scoring run PI on-record and read the predicted field.
get_virtual_agent_topics
List Virtual Agent topics available in the instance (sys_cs_topic)
get_ms_copilot_topics
List the Virtual Agent topics (sys_cs_topic) that back a Microsoft Copilot integration. Copilot topic mapping itself is configured in Copilot Studio on the Microsoft side, not exposed via ServiceNow REST.
get_pi_models
List available Predictive Intelligence solutions (classification/similarity models)
list_business_rules
List business rules (requires SCRIPTING_ENABLED=true)
get_business_rule
Get full details and script body of a business rule (requires SCRIPTING_ENABLED=true)
create_business_rule
Create a new business rule (requires SCRIPTING_ENABLED=true). ServiceNow supports ES2021 async/await in scripts.
update_business_rule
Update a business rule (requires SCRIPTING_ENABLED=true)
list_script_includes
List script includes (requires SCRIPTING_ENABLED=true)
get_script_include
Get full script body of a script include (requires SCRIPTING_ENABLED=true)
create_script_include
Create a new script include (requires SCRIPTING_ENABLED=true)
update_script_include
Update a script include (requires SCRIPTING_ENABLED=true)
list_client_scripts
List client scripts (requires SCRIPTING_ENABLED=true)
get_client_script
Get full details and script body of a client script (requires SCRIPTING_ENABLED=true)
list_changesets
List update sets (changesets) (requires SCRIPTING_ENABLED=true)
get_changeset
Get details of an update set (requires SCRIPTING_ENABLED=true)
commit_changeset
Commit an update set (requires SCRIPTING_ENABLED=true)
publish_changeset
Publish/export an update set to XML for deployment (requires SCRIPTING_ENABLED=true)
create_client_script
Create a new client script (onLoad, onChange, onSubmit, onCellEdit) (requires SCRIPTING_ENABLED=true)
update_client_script
Update an existing client script (requires SCRIPTING_ENABLED=true)
list_ui_policies
List UI Policies for a table (field visibility, mandatory, read-only rules) (requires SCRIPTING_ENABLED=true)
get_ui_policy
Get full details and conditions of a UI Policy (requires SCRIPTING_ENABLED=true)
create_ui_policy
Create a new UI Policy to control field behavior dynamically (requires SCRIPTING_ENABLED=true)
list_ui_actions
List UI Actions (buttons, context menus, related links) for a table (requires SCRIPTING_ENABLED=true)
get_ui_action
Get full details and script of a UI Action (requires SCRIPTING_ENABLED=true)
create_ui_action
Create a new UI Action (button or link) on a form (requires SCRIPTING_ENABLED=true)
update_ui_action
Update an existing UI Action (requires SCRIPTING_ENABLED=true)
list_acls
List Access Control rules (ACLs) — who can read/write/create/delete records (requires SCRIPTING_ENABLED=true)
get_acl
Get full details of an ACL rule including its script and role requirements (requires SCRIPTING_ENABLED=true)
create_acl
Create a new ACL rule to control access to a table or field (requires SCRIPTING_ENABLED=true)
update_acl
Update an existing ACL rule (requires SCRIPTING_ENABLED=true)
create_story
Create a new agile story/user story (requires WRITE_ENABLED=true)
update_story
Update an agile story (requires WRITE_ENABLED=true)
list_stories
List agile stories with optional sprint or state filter
create_epic
Create a new epic (requires WRITE_ENABLED=true)
update_epic
Update an epic (requires WRITE_ENABLED=true)
list_epics
List epics with optional project or state filter
create_scrum_task
Create a scrum task (sub-task of a story) (requires WRITE_ENABLED=true)
update_scrum_task
Update a scrum task (requires WRITE_ENABLED=true)
list_scrum_tasks
List scrum tasks, optionally filtered by story
create_story_dependency
Link one agile story as dependent on another (m2m_story_dependencies). Requires WRITE_ENABLED=true.
list_story_dependencies
List dependency links for a story (m2m_story_dependencies).
delete_story_dependency
Remove a story dependency link by its m2m_story_dependencies sys_id. Requires WRITE_ENABLED=true.
create_project
Create a PPM project (pm_project). Requires WRITE_ENABLED=true.
update_project
Update a PPM project (pm_project). Requires WRITE_ENABLED=true.
list_projects
List PPM projects (pm_project).
create_hr_case
Create a new HR Service Delivery case (requires WRITE_ENABLED=true)
get_hr_case
Get full details of an HR case by number (e.g. HRCS0001234) or sys_id
update_hr_case
Update fields on an existing HR case (requires WRITE_ENABLED=true)
list_hr_cases
List HR cases with optional filters (status, subject person, service)
close_hr_case
Close an HR case with resolution notes (requires WRITE_ENABLED=true)
list_hr_services
List available HR services (Onboarding, Offboarding, Benefits, Payroll, etc.)
get_hr_service
Get details of a specific HR service including its tasks and SLAs
get_hr_profile
Get the HR profile for a user (employment details, department, manager)
update_hr_profile
Update HR profile fields for a user (requires WRITE_ENABLED=true)
list_hr_tasks
List HR tasks associated with an HR case
create_hr_task
Create a task within an HR case (requires WRITE_ENABLED=true)
get_hr_case_activity
Get the full activity log and journal entries for an HR case
create_onboarding_case
Create an employee onboarding case with all standard tasks. **[Write]**
create_offboarding_case
Create an employee offboarding case with exit tasks. **[Write]**
get_hr_lifecycle_events
Get HR lifecycle events for an employee (promotions, transfers, leaves)
list_hr_document_templates
List available HR document templates (offer letters, contracts, policies)
create_csm_case
Create a new Customer Service case (requires WRITE_ENABLED=true)
get_csm_case
Get full details of a CSM case by number (e.g. CS0001234) or sys_id
update_csm_case
Update fields on an existing CSM case (requires WRITE_ENABLED=true)
list_csm_cases
List CSM cases with optional filters (account, contact, state, priority)
close_csm_case
Close a CSM case with resolution details (requires WRITE_ENABLED=true)
get_csm_account
Get details of a customer account including contacts and open cases count
list_csm_accounts
List customer accounts with optional search filter
get_csm_contact
Get details of a customer contact (name, account, phone, email)
list_csm_contacts
List contacts for an account or search across all contacts
get_csm_case_sla
Get SLA details and remaining time for a CSM case
list_csm_products
List products and services available in the CSM catalog
create_security_incident
Create a Security Operations incident (requires WRITE_ENABLED=true)
get_security_incident
Get full details of a security incident by number or sys_id
update_security_incident
Update a security incident record (requires WRITE_ENABLED=true)
list_security_incidents
List security incidents with filters (severity, state, category)
list_vulnerabilities
List vulnerability entries from the Vulnerability Response module
get_vulnerability
Get details of a specific vulnerability entry including CVSS score and affected CIs
update_vulnerability
Update a vulnerability entry (state, risk acceptance notes, remediation date) (requires WRITE_ENABLED=true)
list_grc_risks
List GRC (Governance, Risk, Compliance) risk entries
get_grc_risk
Get details of a GRC risk including impact, likelihood, and controls
list_grc_controls
List GRC controls with optional filter by risk or policy
get_threat_intelligence
Query threat intelligence data — IOCs, threat actors, and campaigns
list_security_playbooks
List available security response playbooks
run_security_playbook
Execute a security response playbook against an incident. **[Write]**
get_security_dashboard
Get security posture dashboard — open incidents by severity, vulnerability counts, mean time to resolve
scan_vulnerabilities
Trigger a vulnerability scan for specified CIs or groups. **[Write]**
create_grc_risk
Create a new GRC risk entry. **[Write]**
list_compliance_policies
List GRC compliance policies and their current status
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"nowaikit": {
"nowaikit": {
"command": "npx",
"args": [
"-y",
"nowaikit@latest"
],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_METHOD": "oauth",
"SERVICENOW_CLIENT_ID": "<your-client-id>",
"SERVICENOW_CLIENT_SECRET": "<your-client-secret>"
}
}
}
}
}
McpServers
{
"nowaikit": {
"command": "npx",
"args": [
"-y",
"nowaikit@latest"
],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_METHOD": "oauth",
"SERVICENOW_CLIENT_ID": "<your-client-id>",
"SERVICENOW_CLIENT_SECRET": "<your-client-secret>"
}
}
}
NowAIKit
The Most Comprehensive ServiceNow AI Toolkit
> 400+ tools · 31+ ServiceNow modules · 5-minute setup · Free to use · Works with any AI
NowAIKit is the most comprehensive, production-ready AI toolkit for ServiceNow — and the only one that truly does it all.
Connect Claude, ChatGPT, Gemini, Cursor, GitHub Copilot, or any MCP-compatible AI in under 5 minutes. Then let your AI read, build, deploy, and automate across every ServiceNow module — incidents, changes, scripts, flows, portals, integrations, HRSD, CSM, and more.
Ask in plain English. Deploy business rules from chat. Run ATF suites on demand. Query dev, staging, and prod simultaneously. Automate across multiple customer tenants without switching tabs. Your AI, your instance, your rules.
Any AI. Any instance. Any scale. Free to use.
> Keywords: ServiceNow MCP server · Model Context Protocol · ServiceNow AI · ITSM automation · ServiceNow Claude · ServiceNow ChatGPT · ServiceNow Cursor · ServiceNow Copilot · ServiceNow LLM · ServiceNow agent · MCP tools · ServiceNow API · agentic AI · ServiceNow developer tools
<br/>
| | |
|---|---|
| Beginners | Zero ServiceNow API knowledge needed. Connect in 5 minutes. Ask in plain English. Free PDI at developer.servicenow.com. |
| Developers | Write, deploy, test, and manage scripts, flows, widgets, and integrations at AI speed — 10x faster. |
| Architects & MSPs | Orchestrate multi-step autonomous workflows. Compare environments. Manage multiple customer tenants in one session. |
<br/>
</div>
---
Who Is This For?
<table>
<tr>
<td width="33%" valign="top">
Beginners
Zero ServiceNow API knowledge required.Connect Claude Desktop or Cursor to your free PDI in 5 minutes. Ask questions in plain English, browse incidents, search KB articles, place catalog orders, monitor SLAs — all from your AI chat window. No code. No Postman. No documentation diving. Just ask.
Start here → 5-Minute Quickstart
</td>
<td width="33%" valign="top">
Developers
10x faster with AI as your development partner.Write business rules, deploy client scripts, manage UI Policies and ACLs, create Service Portal widgets, configure REST Messages, manage Transform Maps, and update changesets — all in plain English. Full TypeScript types, ATF integration, and role-based packages built in.
Explore → Platform Developer Package
</td>
<td width="33%" valign="top">
Architects, Admins & MSPs
Autonomous workflows. Multi-instance. Multi-customer.Trigger Agentic Playbooks, orchestrate multi-step ITSM/HRSD/CSM processes, compare environments side by side, manage dozens of customer tenants in one session, and run full data quality audits — at AI speed, across your entire ServiceNow estate.
Deep dive → Now Assist & Agentic Guide
</td>
</tr>
</table>
---
Why NowAIKit
<table>
<tr>
<td width="33%" valign="top">
Fully Autonomous AI Operations
Your AI doesn't just answer questions — it acts. Create incidents, write and deploy scripts, trigger flows, fire events, upload attachments, manage changesets, and run full ATF suites — end-to-end, without manual steps. Native Now Assist Agentic Playbook support for next-generation ServiceNow AI automation.
</td>
<td width="33%" valign="top">
Works With Every AI, Out of the Box
Claude, ChatGPT, Gemini, Grok, Cursor, Windsurf, GitHub Copilot, Amazon Q, JetBrains, Continue.dev, Cline, Zed, Google AI Studio, Ollama — all supported out of the box. Any MCP-compatible client. Any custom Python or TypeScript agent. One toolkit, every AI platform, zero lock-in.
</td>
<td width="33%" valign="top">
Unmatched Platform Coverage
400+ production-ready tools across every ServiceNow domain — ITSM, ITOM, HRSD, CSM, SecOps, GRC, Agile, ATF, Flow Designer, Scripting, Now Assist, Service Portal, Integration Hub, Performance Analytics, System Properties, Update Sets, Virtual Agent, ITAM, DevOps, Machine Learning, Workspace/UIB, Mobile, and Deployment. Nothing else comes close.
</td>
</tr>
<tr>
<td width="33%" valign="top">
Role-Based Tool Intelligence
Fourteen pre-built persona packages — service desk, platform developer, portal developer, integration engineer, ITOM engineer, AI developer, ITAM analyst, DevOps engineer, and more. Each exposes exactly the right tools for that role. Reduce noise, enforce least-privilege, and configure once per team.
</td>
<td width="33%" valign="top">
Safe by Default, Powerful When Needed
A five-tier permission model keeps your instance protected. Read is always on. Write, CMDB, Scripting, Now Assist, and ATF capabilities each require an explicit opt-in flag. No AI can accidentally modify your production data. Scale permissions as your confidence grows — without touching code.
</td>
<td width="33%" valign="top">
True Multi-Instance & Multi-Customer
Connect to unlimited ServiceNow instances from one session — dev, staging, prod, and multiple customer tenants simultaneously. Pass instance: "acme_prod" on any tool call, or switch_instance globally. MSPs, consultants, and enterprise teams can compare, query, and automate across every environment at once. No other ServiceNow AI toolkit does this.
</td>
</tr>
</table>
---
Quick Links
| Resource | Link |
|----------|------|
| All Tools Reference | docs/TOOLS.md |
| Client Setup (All AI tools, beginner + advanced) | docs/CLIENT_SETUP.md |
| Role-Based Tool Packages | docs/TOOL_PACKAGES.md |
| Now Assist & AI Integration | docs/NOW_ASSIST.md |
| ATF Testing Guide | docs/ATF.md |
| Scripting Management | docs/SCRIPTING.md |
| Reporting & Analytics | docs/REPORTING.md |
| Multi-Instance Setup | docs/MULTI_INSTANCE.md |
| 120+ Real-World Examples | EXAMPLES.md |
| Changelog | CHANGELOG.md |
---
Module Coverage
Domain modules covering the full ServiceNow platform:
| Module | Key Capabilities |
|--------|-----------------|
| Core & CMDB | Record query, schema discovery, CMDB CIs, ITOM Discovery, MID Servers, multi-instance management |
| Incident Management | Create, update, resolve, close, work notes, comments |
| Problem Management | Problem records, root cause analysis, known errors |
| Change Management | Create, get, update, submit for approval, close change requests |
| Task Management | Generic tasks, my-task lists, completions |
| Knowledge Base | Search, create, update, publish KB articles |
| Service Catalog & Approvals | Catalog browsing, create/update items, order items, SLA tracking, approval workflows, approval rules |
| User & Group Management | Users, groups, membership, role assignments |
| Reporting & Analytics | Aggregate queries, trend analysis, create/update reports, scheduled job CRUD, run history |
| ATF Testing | Test suites, test execution, ATF Failure Insight |
| Now Assist / AI | NLQ, AI Search, summaries, resolution suggestions, Agentic Playbooks |
| Scripting | Business rules, script includes, client script CRUD, UI Policies, UI Actions, ACL management, changesets |
| Agile / Scrum | Stories, epics, sprints, scrum tasks |
| HR Service Delivery (HRSD) | HR cases, HR services, employee profiles, onboarding/offboarding |
| Customer Service Management (CSM) | Customer cases, accounts, contacts, products, SLAs |
| Security Operations & GRC | SecOps incidents, vulnerabilities, GRC risks, controls, threat intel |
| Flow Designer & Process Automation | Flows, subflows, triggers, executions, Process Automation playbooks |
| Service Portal & UI Builder | Create/list portals & pages, widgets (create/update/deploy), Next Experience apps/pages, themes |
| Integration Hub | REST Messages, Transform Maps, Import Sets, Event Registry, OAuth apps, credential aliases |
| Notifications & Attachments | Email notifications, email logs, file attachments (upload/list/delete), templates, subscriptions |
| Performance Analytics | PA indicators/scorecards, time-series, create/update dashboards, PA jobs, data quality checks |
| System Properties | Get, set, bulk operations, validate, export/import, audit history |
| Update Set Management | Create, switch, preview, complete, export, auto-ensure active set |
| Virtual Agent (VA) | Topic authoring, conversation history, categories, topic listing |
| IT Asset Management (ITAM) | Assets, software licenses, contracts, compliance reporting |
| DevOps & Pipeline Tracking | Pipelines, deployments, change governance, DORA metrics |
| Scoped Applications (App Studio) | List, get, create, and update scoped application records |
---
Authentication
Two authentication methods are supported:
| Method | Best For |
|--------|----------|
| Basic Auth | Development, personal instances, quick setup |
| OAuth 2.0 (client credentials / password grant) | Production deployments, service accounts |
SSO / OIDC authentication (Okta, Azure AD / Entra, Ping Identity) is available in the Enterprise edition — see nowaikit.com/#pricing.
For OAuth setup in ServiceNow, see docs/SERVICENOW_OAUTH_SETUP.md.
---
Permission System
A four-tier permission model keeps your instance safe by default:
| Tier | Environment Variable | Covers |
|------|---------------------|--------|
| 0 — Read | (always on) | All query and read operations |
| 1 — Write | WRITE_ENABLED=true | Create/update across ITSM, HRSD, CSM, Agile |
| 2 — CMDB Write | CMDB_WRITE_ENABLED=true | CI create/update in the CMDB |
| 3 — Scripting | SCRIPTING_ENABLED=true | Business rules, script includes, changesets |
| 4 — Now Assist | NOW_ASSIST_ENABLED=true | AI Agentic Playbooks, NLQ, AI Search |
---
Role-Based Tool Packages
Set MCP_TOOL_PACKAGE to expose only the tools relevant to each persona:
| Package | Persona | Tools Included |
|---------|---------|---------------|
| full | Administrators | All tools (400+) |
| service_desk | L1/L2 Agents | Incidents, tasks, approvals, KB, SLA |
| change_coordinator | Change Managers | Changes (create/approve/close), CAB, CMDB, approvals |
| knowledge_author | KB Authors | Knowledge base create/publish |
| catalog_builder | Catalog Admins | Catalog, users, groups |
| system_administrator | Sys Admins | Users, groups, reports, logs, notifications, attachments, ACLs, PA |
| platform_developer | Developers | Scripts, UI Policies, UI Actions, ACLs, client scripts, ATF, changesets |
| portal_developer | Portal/UX Devs | Portals, pages, widgets (create/update), UI Policies, UI Actions, client scripts |
| integration_engineer | Integration Devs | REST Messages, Transform Maps, Import Sets, Events, OAuth, credentials |
| itom_engineer | ITOM Engineers | CMDB, Discovery, MID servers, events |
| agile_manager | Scrum Masters | Stories, epics, sprints |
| ai_developer | AI Builders | Now Assist, NLQ, Agentic Playbooks |
---
Getting Started
Option A — Interactive Setup Wizard (Recommended)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


