A comprehensive ServiceNow integration exposing over 400 tools across ITSM, HRSD, CSM, ITOM, and scripting modules. Handles the full lifecycle: query incidents and changes, deploy business rules and client scripts, trigger ATF test suites, manage Service Portal widgets, run Now Assist Agentic Playbooks, and coordinate multi-instance operations across dev, staging, and production environments. Built with role-based tool packages for service desk agents, platform developers, integration engineers, and MSPs managing multiple customer tenants. Includes five-tier permission controls where read operations are always available and write, CMDB, scripting, and AI capabilities require explicit opt-in. Works with Claude, ChatGPT, Cursor, and any MCP-compatible client through stdio transport.
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
| 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. |
BeginnersZero 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 |
Developers10x 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 |
Architects, Admins & MSPsAutonomous 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 |
Fully Autonomous AI OperationsYour 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. |
Works With Every AI, Out of the BoxClaude, 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. |
Unmatched Platform Coverage400+ 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. |
Role-Based Tool IntelligenceFourteen 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. |
Safe by Default, Powerful When NeededA 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. |
True Multi-Instance & Multi-CustomerConnect to unlimited ServiceNow instances from one session — dev, staging, prod, and multiple customer tenants simultaneously. Pass |
| 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 |
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 |
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.
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 |
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 |
# Install globally (Node.js 20+ required)
npm install -g nowaikit
# Run the wizard — detects your AI clients and writes config automatically
npx nowaikit setup
The wizard will:
# Add a second instance later
nowaikit setup --add
# Manage instances
nowaikit instances list
npx nowaikit web
Opens the NowAIKit dashboard at http://localhost:4175 — includes instance management, settings, and an audit log viewer.
# Custom port
npx nowaikit web --port 3000
# Expose to network (use with caution)
npx nowaikit web --host 0.0.0.0
# Don't auto-open browser
npx nowaikit web --no-open
Download the native desktop app (macOS, Windows, Linux) from GitHub Releases. Includes a visual setup wizard, tool browser, and audit log viewer.
git clone https://github.com/aartiq/nowaikit.git && cd nowaikit
npm install && npm run build
cp .env.example .env # fill in your ServiceNow credentials
Then point your AI client at dist/server.js — see Supported AI Clients below.
No ServiceNow instance? Get a free Personal Developer Instance at developer.servicenow.com — ready in minutes.
Full installation guide → docs/INSTALLATION.md
Step-by-step setup for every major AI client — Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Zed, GitHub Copilot, Continue.dev, Cline, JetBrains, Amazon Q, Google AI Studio, ChatGPT, Grok, Ollama, and more.
Full guide → docs/CLIENT_SETUP.md
Once connected, ask your AI assistant in plain language:
ITSM & Change Management:
Show me all open P1 incidents assigned to the Network Operations group.
Create a normal change request for deploying the new API gateway — implementation planned for Saturday midnight.
What CMDB CIs does the ERP application depend on?
Scripting & Development:
List all client scripts on the incident table and show me the ones that fire on form load.
Create a UI action button "Escalate to L3" on the incident form that assigns the ticket to the L3-Support group.
Show me all ACL rules for the change_request table that restrict the "delete" operation.
Service Portal & UI Builder:
List all widgets in the Service Portal that contain "catalog" in their name.
Get the full source code of the "Stock Ticker" widget so I can update its server script.
Create a new portal widget called "My Approvals Widget" with a simple Angular template that lists pending approvals.
Integrations & Events:
List all REST Message definitions that connect to external APIs.
Show me all transform maps that target the incident table.
Fire the custom event "myapp.ticket.escalated" on incident INC0012345.
Notifications & Attachments:
List all email notifications that trigger on the incident table when a comment is added.
Upload a screenshot of the error (base64) as an attachment to incident INC0012345.
Show me all failed email log entries from the last 24 hours.
Performance Analytics & Data Quality:
Get the current scorecard for the "Mean Time to Resolve" PA indicator with a 30-day trend.
Check the data completeness of the incident table — how many incidents are missing assignment_group or category?
Compare record counts across incident, change_request, and problem tables.
ATF, Reporting & Scheduled Jobs:
Run the Regression Test Suite and show me any failures with ATF Failure Insight details.
Summarise the last 30 days of incident trends by category.
Create a scheduled job that runs daily at 3am to archive closed incidents older than 90 days.
For 120+ real-world examples with inputs, outputs, and advanced workflows, see EXAMPLES.md.
Once connected, type / in Claude Desktop or Cursor to see built-in ServiceNow shortcuts:
| Command | What it does |
|---|---|
/morning-standup | P1/P2 open incidents, changes due today, SLA breaches |
/my-tickets | All open tasks/incidents assigned to you |
/p1-alerts | Active P1 incidents with time-open and assignee |
/my-changes | Your pending change requests and approval status |
/create-incident | Guided incident creation |
/sla-breaches | Records currently breaching SLA |
/ci-health | CMDB CI health check |
/run-atf | Trigger ATF test suite |
/switch-instance | Interactive instance picker |
/knowledge-search | Search KB articles |
/deploy-updateset | Guided update set commit |
Type @ to pull live ServiceNow data into your AI context:
| Mention | Returns |
|---|---|
@my-incidents | Your open incidents |
@open-changes | Pending change requests |
@sla-breaches | Records breaching SLA now |
@instance:info | Current instance metadata |
@ci:<name> | CMDB CI by name |
@kb:<title> | Knowledge article by title |
Add your own commands in nowaikit.commands.json:
[
{
"name": "my-p1-runbook",
"description": "P1 runbook for my team",
"template": "List all P1 incidents in the Network category. For each: number, description, assignee, time open. Flag SLA breaches."
}
]
| Topic | Guide |
|---|---|
| OAuth 2.0 setup (ServiceNow OAuth app creation) | docs/SERVICENOW_OAUTH_SETUP.md |
| Multi-instance / multi-customer (dev, staging, prod, tenants) | docs/MULTI_INSTANCE.md |
| Role-based tool packages | docs/TOOL_PACKAGES.md |
| All environment variables reference | docs/INSTALLATION.md |
The following features are available in NowAIKit Pro and Enterprise editions:
| Feature | Edition |
|---|---|
| HTTP API server & web dashboard | Pro |
| Desktop app (macOS, Windows, Linux) | Pro |
| SSO / OIDC (Okta, Azure AD / Entra, Ping Identity) | Enterprise |
| Audit logging (JSONL + SIEM webhooks) | Enterprise |
| Org policy governance (MDM / GPO deployment) | Enterprise |
Learn more at nowaikit.com/#pricing.
These are real interactions you can have with your AI once NowAIKit is connected:
Operations — plain English:
You: "Show me all P1 incidents opened this week that are still unresolved"
You: "Which assignment groups have the most open incidents right now?"
You: "Find all change requests scheduled for this weekend"
You: "Is any SLA about to breach in the next 2 hours?"
Development — AI writes and deploys for you:
You: "Create a business rule that auto-assigns high-priority incidents to the NOC group"
You: "Write a client script that validates email format on the contact form"
You: "Create a Service Portal widget that shows my team's open tasks"
You: "Set up a REST Message integration to send alerts to our Slack channel"
AI-powered intelligence:
You: "Summarise this incident and suggest a resolution based on similar past cases"
You: "Use Predictive Intelligence to categorise this new incident description"
You: "Trigger the SOC Agentic Playbook for this security incident"
You: "What's the trend in P2 incidents over the last 6 months?"
Advanced automation:
You: "Compare record counts between prod and dev for the incident table"
You: "Check data completeness on the cmdb_ci_server table — which fields are mostly empty?"
You: "Run the nightly sync transform map on the latest import set"
You: "Create a scheduled job that emails the on-call team daily at 7am"
Multi-instance & multi-customer:
You: "List all configured instances"
You: "Switch to customer_acme and show me their open P1 incidents"
You: "Compare open change counts between prod and staging"
You: "Get SLA breach risk from customer_globex prod instance"
See EXAMPLES.md for 120+ real-world examples across all ServiceNow modules.
Any MCP-compatible AI works. NowAIKit has been tested with every major AI assistant, editor, and agent framework. Pick yours and follow the 3-step setup below.
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "false"
}
}
}
}
Or use multi-instance (dev + staging + prod, or multiple customer tenants):
{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SN_INSTANCES_CONFIG": "/absolute/path/to/instances.json"
}
}
}
}
Copy instances.example.json → instances.json, fill in your instances, then ask:
"List instances" → "Switch to prod" → "Show me all P1 incidents" "Get open changes from customer_acme" (uses
instanceparameter per-call)
Full guide → clients/claude-desktop/SETUP.md | docs/MULTI_INSTANCE.md
OpenAI supports MCP via the Responses API (mcp tool type) in the latest SDK (v1.50+):
from openai import OpenAI
import os, subprocess
# Start NowAIKit as a subprocess MCP server
proc = subprocess.Popen(
["node", "/path/to/nowaikit/dist/server.js"],
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
env={**os.environ,
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"}
)
client = OpenAI()
# Use with Responses API tool type "mcp" or via function calling
response = client.responses.create(
model="gpt-4o",
tools=[{"type": "mcp", "server_label": "nowaikit"}],
input="Show me all open P1 incidents"
)
Full guide → docs/CLIENT_SETUP.md
npm install -g nowaikitclients/gemini/:pip install google-generativeai
python clients/gemini/servicenow_gemini_client.py
Full guide → clients/gemini/SETUP.md
Google AI Studio supports MCP servers via its agent execution environment (currently in preview).
{
"name": "nowaikit",
"transport": "stdio",
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "false"
}
}
import google.generativeai as genai
import subprocess, json, os
# Start NowAIKit MCP server
proc = subprocess.Popen(
["node", "/path/to/nowaikit/dist/server.js"],
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
env={**os.environ,
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"}
)
genai.configure(api_key=os.environ["GOOGLE_API_KEY"])
model = genai.GenerativeModel("gemini-3.1-pro") # or gemini-3-flash, gemini-2.5-flash
# Use model.generate_content() with tools= mapped from NowAIKit definitions
Full guide → docs/CLIENT_SETUP.md
base_url="https://api.x.ai/v1" and your XAI_API_KEYFull guide → docs/CLIENT_SETUP.md
{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "true",
"SCRIPTING_ENABLED": "true"
}
}
}
}
Multi-instance: Replace the env block with "SN_INSTANCES_CONFIG": "/path/to/instances.json" to connect to multiple tenants.
Full guide → clients/cursor/SETUP.md
Full guide → docs/CLIENT_SETUP.md
~/.config/zed/settings.json"context_servers":{
"context_servers": {
"nowaikit": {
"command": { "path": "node", "args": ["/path/to/nowaikit/dist/server.js"] },
"settings": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
}
}
Full guide → docs/CLIENT_SETUP.md
VS Code 1.99 and later includes built-in MCP support — no extension or subscription required.
.vscode/mcp.json in your workspace (or edit User settings):{
"servers": {
"nowaikit": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "true",
"SCRIPTING_ENABLED": "true"
}
}
}
}
Cmd/Ctrl+Shift+P) → MCP: List Servers to verify the connection@nowaikit or just ask naturallyTip: Add
.vscode/mcp.jsonto.gitignoreif it contains credentials, or use environment variables from a.envfile.
Full guide → clients/vscode/SETUP.md
.vscode/mcp.json in your project:{
"servers": {
"nowaikit": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/../../nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
}
}
@nowaikitFull guide → clients/vscode/SETUP.md
~/.continue/config.json:{
"mcpServers": [
{
"name": "nowaikit",
"command": "node",
"args": ["/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
]
}
Full guide → docs/CLIENT_SETUP.md
nowaikit/dist/server.js and your environment variablesFull guide → docs/CLIENT_SETUP.md
nowaikit/dist/server.jsFull guide → docs/CLIENT_SETUP.md
~/.aws/amazonq/mcp.json:{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
}
}
Full guide → docs/CLIENT_SETUP.md
# Install Claude Code
npm install -g @anthropic-ai/claude-code
# Register NowAIKit as an MCP server
claude mcp add nowaikit node /absolute/path/to/nowaikit/dist/server.js \
--env SERVICENOW_INSTANCE_URL=https://yourinstance.service-now.com \
--env SERVICENOW_AUTH_METHOD=basic \
--env SERVICENOW_BASIC_USERNAME=admin \
--env SERVICENOW_BASIC_PASSWORD=your_password
# Verify
claude mcp list
# Use it
claude "Show me all unresolved P1 incidents"
Full guide → clients/claude-code/SETUP.md
ollama pull llama3nowaikit/dist/server.jsFull guide → docs/CLIENT_SETUP.md
cd clients/codex
pip install -r requirements.txt
cp .env.basic.example .env # fill in your credentials
python servicenow_openai_client.py
Full guide → clients/codex/SETUP.md
import anthropic, subprocess, json
# Start NowAIKit subprocess
proc = subprocess.Popen(
["node", "/path/to/nowaikit/dist/server.js"],
stdin=subprocess.PIPE, stdout=subprocess.PIPE,
env={**os.environ,
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"}
)
# Then use with the Anthropic MCP client SDK
See Anthropic MCP Python SDK for full integration.
| Client | Type | Auth | Guide |
|---|---|---|---|
| Claude Desktop | Desktop app | Basic, OAuth | Setup |
| Claude Code CLI | Terminal | Basic, OAuth | Setup |
| Cursor | AI editor | Basic, OAuth | Setup |
| Windsurf | AI editor | Basic, OAuth | Setup |
| Zed | AI editor | Basic, OAuth | Setup |
| VS Code (Native MCP 1.99+) | IDE | Basic, OAuth | Setup |
| VS Code + GitHub Copilot | IDE | Basic, OAuth | Setup |
| VS Code + Continue.dev | IDE | Basic, OAuth | Setup |
| VS Code + Cline | IDE | Basic, OAuth | Setup |
| JetBrains AI | IDE | Basic, OAuth | Setup |
| Amazon Q Developer | IDE / CLI | Basic, OAuth | Setup |
| ChatGPT / OpenAI | API | Basic, OAuth | Setup |
| Google AI Studio | API / Agent | Basic, OAuth | Setup |
| Google Gemini API | API | Basic, OAuth | Setup |
| Grok (xAI) | API | Basic, OAuth | Setup |
| Ollama (local) | Local | Basic | Setup |
| Anthropic Agent SDK | Python | Basic, OAuth | Setup |
The nowaikit Desktop and Web Dashboard support 5 AI providers side-by-side — with full agentic tool-use for all providers. All model lists are kept current with each provider's latest releases.
max_completion_tokens; tools not sent to models that don't support themSettings → AI Providers now shows a unified "Sign in to {Provider}" flow per provider:
Each provider panel shows a clear subscription note explaining that API access is separate from consumer subscriptions (Claude.ai Pro, ChatGPT Plus, Gemini Advanced). Groq and OpenRouter offer generous free tiers — no credit card required.
Type / in the chat input to open a floating picker over all 400+ ServiceNow tools:
↑ / ↓ to navigate · Tab or Enter to select · Esc to close/toolname into your message — the AI knows to invoke that specific tool… (full URL on hover)npx nowaikit setup — interactive wizard detects and writes config for every AI client automatically. No JSON editing.http://localhost:3100 by the HTTP server. Browse tools, view health, tail audit logs./ slash commands — /morning-standup, /p1-alerts, /my-tickets, /create-incident, /sla-breaches, /ci-health, /run-atf, /switch-instance, /deploy-updateset, and more@ mention resources — @my-incidents, @open-changes, @sla-breaches, @instance:info, @ci:<name>, @kb:<title>nowaikit.commands.jsonGET /auth/login + /auth/callback routes in HTTP server.nowaikit.org.json) — admin-deployed config: allowed instances, locked tool packages, SSO enforcement, write controls. Deploy via MDM or GPO.service-account, per-user (OAuth Authorization Code), impersonation. Queries respect each user's ServiceNow ACLs.npm run serve) — REST proxy for Lovable, Bolt, v0, Replit apps. Keeps credentials server-side.smithery install nowaikit one-command install.list_scoped_apps, get_scoped_app, create_scoped_app, update_scoped_appcreate_report, update_report added to Reporting modulecreate_dashboard, update_dashboard added to Performance Analyticscreate_portal, create_portal_page added to Service Portal modulecreate_catalog_item, update_catalog_item added to Catalog modulecreate_approval_rule for automated approval workflow setup
Full changeloginstance: "name" to any tool, or switch_instance globallydevops_engineer, itam_analystsystem_administrator package extended with system properties and update set tools
Full changeloggenerate_work_notes AI-drafted work notes for any recordportal_developer, integration_engineeruploadAttachment() via ServiceNow Attachment APIdocs/| Guide | Description |
|---|---|
| docs/TOOLS.md | Complete reference for all tools with parameters, return types, and permission requirements |
| docs/CLIENT_SETUP.md | Step-by-step beginner + advanced setup for all AI clients (Claude, ChatGPT, Gemini, Cursor, VS Code, Windsurf, Continue, Cline, Codex, JetBrains, Ollama) |
| docs/TOOL_PACKAGES.md | Role-based package reference — which tools each of the 14 persona packages includes |
| docs/NOW_ASSIST.md | Now Assist and AI integration guide — NLQ, AI Search, Agentic Playbooks |
| docs/ATF.md | ATF testing guide — suites, test runs, ATF Failure Insight |
| docs/SCRIPTING.md | Scripting management — business rules, script includes, UI Policies, UI Actions, ACLs, changesets |
| docs/REPORTING.md | Reporting and analytics — aggregate queries, Performance Analytics, scheduled jobs |
| docs/MULTI_INSTANCE.md | Multi-instance configuration via instances.json or environment variables |
| docs/SERVICENOW_OAUTH_SETUP.md | Creating an OAuth application in ServiceNow for secure API access |
| docs/INSTALLATION.md | Full installation guide including wizard, enterprise config, SSO, and audit logging |
| clients/lovable/SETUP.md | HTTP API server — integrate with Lovable, Bolt, v0, Replit apps |
| desktop/BUILDING.md | Build and code-sign the Electron desktop app |
| EXAMPLES.md | 120+ real-world examples with inputs, outputs, and advanced workflows |
npm install # install dependencies
npm run build # compile TypeScript → dist/
npm test # run unit tests
npm run dev # watch mode (hot reload)
npm run type-check # TypeScript type check only
npm run lint # lint
src/
server.ts — MCP server entry point (stdio)
http-server.ts — HTTP API server (REST proxy for web apps)
servicenow/
client.ts — ServiceNow REST API client (Basic / OAuth / per-user)
instances.ts — Multi-instance manager
types.ts — TypeScript type definitions + AuthMode
tools/
index.ts — Tool router & role-based package system
core.ts, incident.ts, change.ts, problem.ts, task.ts
knowledge.ts, catalog.ts, user.ts, reporting.ts, atf.ts
now-assist.ts, script.ts, agile.ts, hrsd.ts, csm.ts
security.ts, flow.ts, portal.ts, integration.ts, notification.ts
performance.ts, sys-properties.ts, updateset.ts, va.ts, itam.ts, devops.ts
prompts/
index.ts — MCP prompts registry (/ slash commands)
itsm.ts — 11 built-in slash commands
user-prompts.ts — Custom commands from nowaikit.commands.json
resources/
index.ts — MCP resources (@ mentions)
auth/
sso.ts — OIDC/SSO module (IdP → ServiceNow token exchange)
dashboard/
html.ts — Web dashboard (served at GET /)
cli/
index.ts — CLI entry point (commander.js)
setup.ts — Interactive setup wizard
detect-clients.ts — Auto-detect installed AI clients
config-store.ts — ~/.config/nowaikit/instances.json
auth.ts — nowaikit auth login/logout/whoami
writers/index.ts — Write configs to AI client config files
utils/
permissions.ts — Five-tier permission gate functions
audit.ts — Structured JSONL audit logger + webhook
org-config.ts — Org/team policy loader (nowaikit.org.json)
errors.ts — Typed error classes
logging.ts — Structured logger
desktop/
main/ — Electron main process (Node.js)
renderer/src/ — React 18 UI (Vite)
electron-builder.yml — Cross-platform packaging config
BUILDING.md — Desktop build & code-signing guide
tests/
tools/ — Unit tests
docs/ — Reference documentation
clients/
claude-desktop/ — Claude Desktop setup guide
cursor/ — Cursor setup guide
vscode/ — VS Code setup guide
claude-code/ — Claude Code setup guide
lovable/ — Lovable/Bolt/v0/Replit HTTP proxy guide
codex/ — OpenAI Codex Python client
gemini/ — Google Gemini Python client
smithery.yaml — Smithery registry config
Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.
npm test to passIf you discover a security vulnerability, please follow the responsible disclosure process in SECURITY.md. Do not open a public issue.
Do I need to know the ServiceNow API to use this? No. For beginners, you just connect your AI and ask questions in plain English. The kit handles all API calls automatically.
Which ServiceNow versions are supported? All actively supported ServiceNow releases. The toolkit targets the latest available APIs and has been tested on the three most recent releases — Australia, Zurich, and Yokohama — and works on any currently supported instance.
Can I use this on a free Personal Developer Instance (PDI)? Yes. Get a free PDI at developer.servicenow.com and connect in 5 minutes.
Is it safe to use on production? Yes. The permission system is read-only by default. Write, scripting, and Now Assist capabilities must each be explicitly enabled with environment variables. Use role packages to limit the tool surface.
Can I use multiple AI providers at the same time? Yes. Each AI client gets its own MCP config pointing at the same (or different) NowAIKit instance. Run Claude Desktop and Cursor side by side against the same ServiceNow environment. In the nowaikit Desktop app you can switch between Claude, ChatGPT, and Gemini with one click inside the Chat page.
Does it support multi-instance / multiple customers?
Yes. Configure any number of instances (prod, staging, dev, or multiple customer tenants) via instances.json or environment variables. Use list_instances, switch_instance, and get_current_instance tools to manage them, or pass instance: "name" to any individual tool call. See docs/MULTI_INSTANCE.md.
Is it free? Completely free to use for personal and commercial purposes. See LICENSE for details.
Source Available — free to use for personal and commercial purposes. See LICENSE for details.
400+ tools. 31+ modules. Every AI platform. True multi-instance. Free to use.
NowAIKit • ServiceNow MCP Server • ServiceNow AI Agent • ServiceNow Claude Integration • ServiceNow ChatGPT • ServiceNow Cursor • ServiceNow Gemini • ServiceNow Automation • ServiceNow Developer Tools • ServiceNow Multi-Instance • ServiceNow MSP
If NowAIKit saves you time, please ⭐ star the repository — it helps others find the project.
Built by Hardik Benani · AartiQ
SERVICENOW_INSTANCE_URLYour ServiceNow instance URL (e.g. https://yourinstance.service-now.com)
SERVICENOW_AUTH_METHODAuthentication method: 'basic' or 'oauth'
SERVICENOW_BASIC_USERNAMEServiceNow username (for basic auth)
SERVICENOW_BASIC_PASSWORDServiceNow password (for basic auth)
WRITE_ENABLEDEnable write operations (true/false, default: false)
SCRIPTING_ENABLEDEnable scripting operations (true/false, default: false)
CMDB_WRITE_ENABLEDEnable CMDB write operations (true/false, default: false)
NOW_ASSIST_ENABLEDEnable Now Assist AI features (true/false, default: false)
ATF_ENABLEDEnable ATF test execution (true/false, default: false)
MCP_TOOL_PACKAGERole-based tool package: full, service_desk, platform_developer, etc.