NowAIKit

The Most Comprehensive ServiceNow AI Toolkit

400+ tools · 31+ ServiceNow modules · 5-minute setup · MIT licensed · 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. 100% open-source.

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.

Who Is This For?

Why NowAIKit

Quick Links

Module Coverage

Domain modules covering the full ServiceNow platform:

Authentication

Two authentication methods are supported:

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:

Role-Based Tool Packages

Set MCP_TOOL_PACKAGE to expose only the tools relevant to each persona:

Getting Started

Option A — Interactive Setup Wizard (Recommended)

# 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:

1. Ask for your ServiceNow instance URL + credentials
2. Test the connection
3. Let you pick a tool package and permission level
4. Detect Claude Desktop, Cursor, VS Code, Windsurf, Continue.dev, Claude Code on your machine
5. Write the config directly — no copy-paste, no manual JSON editing

# Add a second instance later
nowaikit setup --add

# Manage instances
nowaikit instances list

Option B — Web Dashboard (one command)

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

Option C — Desktop App

Download the native desktop app (macOS, Windows, Linux) from GitHub Releases. Includes a visual setup wizard, tool browser, and audit log viewer.

Option D — Manual Setup

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

Client Setup Guides

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

For quick setup snippets, see the Supported AI Clients section below.

Example Interactions

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.

Slash Commands & @ Mentions

Once connected, type / in Claude Desktop or Cursor to see built-in ServiceNow shortcuts:

Type @ to pull live ServiceNow data into your AI context:

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."
  }
]

Advanced Configuration

Pro / Enterprise Features

The following features are available in NowAIKit Pro and Enterprise editions:

Learn more at nowaikit.com/#pricing.

See It In Action

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.

Supported AI Clients

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.

AI Assistants & Chat

{
  "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"
      }
    }
  }
}

{
  "mcpServers": {
    "nowaikit": {
      "command": "node",
      "args": ["/absolute/path/to/nowaikit/dist/server.js"],
      "env": {
        "SN_INSTANCES_CONFIG": "/absolute/path/to/instances.json"
      }
    }
  }
}

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"
)

pip install google-generativeai
python clients/gemini/servicenow_gemini_client.py

{
  "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

AI Code Editors

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

IDE Extensions

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  ]
}

{
  "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"
      }
    }
  }
}

CLI & Terminal Agents

# 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"

Programmatic / Agent SDK

cd clients/codex
pip install -r requirements.txt
cp .env.basic.example .env  # fill in your credentials
python servicenow_openai_client.py

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

Quick Reference

What's New in v2.5

Multi-provider AI chat in the Desktop app & Web Dashboard

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.

• Provider switcher — one-click toggle between providers in the Chat header; per-provider model dropdown updates automatically
• Claude (Anthropic) — Opus 4.6 · Sonnet 4.6 · Haiku 4.5
• ChatGPT / OpenAI — GPT-5.2 · GPT-5.2 Pro · GPT-5.1 · GPT-5 mini · GPT-5 nano · GPT-4.1 · GPT-4o · o3 · o4 mini
• Gemini (Google AI) — Gemini 3.1 Pro · Gemini 3 Pro · Gemini 3 Flash · 2.5 Pro · 2.5 Flash · 2.5 Flash Lite
• Groq (free) — Llama 4 Maverick · Llama 4 Scout · Llama 3.3 70B · Llama 3.1 8B — ultra-fast inference, no credit card required
• OpenRouter (200+ models) — unified gateway to OpenAI o1 Pro · xAI Grok 4 · Claude Opus 4.6 · Gemini 2.5 Flash · DeepSeek R1 · Llama 4 Maverick · and more — many free tiers available
• o3/o4 reasoning model support — automatic detection skips system messages and switches to max_completion_tokens; tools not sent to models that don't support them

In-app provider sign-in

Settings → AI Providers now shows a unified "Sign in to {Provider}" flow per provider:

1. Click Sign in to Claude / ChatGPT / Gemini / Groq / OpenRouter — the provider's API key portal opens in your system browser
2. Sign in to your account and create/copy an API key
3. Paste it directly into the focused input that appears
4. Click Verify Key — a lightweight validation call confirms the key is valid before you save

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.

Slash-command tool picker in Chat

Type / in the chat input to open a floating picker over all 400+ ServiceNow tools:

• Filter by tool name or description as you type
• ↑ / ↓ to navigate · Tab or Enter to select · Esc to close
• Inserts /toolname into your message — the AI knows to invoke that specific tool

Other Desktop improvements

• Test Key button — inline on the API key input; calls the provider's model-list endpoint to validate without sending a chat message
• Server health auto-recovery — polls every 8 seconds; "offline" status recovers automatically without restarting the app
• Dashboard URL truncation — long instance URLs are truncated with … (full URL on hover)
• Bug fix: ChatGPT and Gemini responses now display correctly — responses were being silently dropped due to a content-format mismatch between provider response conversion and the renderer; now fully fixed for both providers and the HTTP API server

Full changelog

What's New in v2.4

Zero-config setup & desktop experience

• npx nowaikit setup — interactive wizard detects and writes config for every AI client automatically. No JSON editing.
• nowaikit Desktop — cross-platform Electron app (macOS, Windows, Linux) with 8-step visual wizard, dashboard, tool browser, and audit log. No separate server install needed.
• Web dashboard — served at http://localhost:3100 by the HTTP server. Browse tools, view health, tail audit logs.

Slash commands & @ mentions

• 11 built-in / slash commands — /morning-standup, /p1-alerts, /my-tickets, /create-incident, /sla-breaches, /ci-health, /run-atf, /switch-instance, /deploy-updateset, and more
• 6 @ mention resources — @my-incidents, @open-changes, @sla-breaches, @instance:info, @ci:<name>, @kb:<title>
• Custom commands via nowaikit.commands.json

Enterprise features

• Audit logging — every tool call logged to JSONL file + webhook (SIEM integration). Wired into both MCP and HTTP servers.
• SSO / OIDC — Okta/Entra/Ping IdP → ServiceNow token exchange. GET /auth/login + /auth/callback routes in HTTP server.
• Org/team policy (nowaikit.org.json) — admin-deployed config: allowed instances, locked tool packages, SSO enforcement, write controls. Deploy via MDM or GPO.
• Per-user execution context — auth modes: service-account, per-user (OAuth Authorization Code), impersonation. Queries respect each user's ServiceNow ACLs.

App builder integrations

• HTTP API server (npm run serve) — REST proxy for Lovable, Bolt, v0, Replit apps. Keeps credentials server-side.
• Smithery registry — smithery install nowaikit one-command install.

Full changelog

What's New in v2.3

• Scoped Application (App Studio) module — list_scoped_apps, get_scoped_app, create_scoped_app, update_scoped_app
• Create/update reports — create_report, update_report added to Reporting module
• Create/update dashboards — create_dashboard, update_dashboard added to Performance Analytics
• Create portals & pages — create_portal, create_portal_page added to Service Portal module
• Create/update catalog items — create_catalog_item, update_catalog_item added to Catalog module
• Approval rules — create_approval_rule for automated approval workflow setup Full changelog

What's New in v2.2

• 5 new modules: System Properties, Update Set Management, Virtual Agent authoring, IT Asset Management, DevOps & Pipeline Tracking
• True multi-instance & multi-customer support — connect to unlimited instances (dev, staging, prod, customer tenants) simultaneously from one session
• Per-call instance routing — pass instance: "name" to any tool, or switch_instance globally
• 2 new role packages — devops_engineer, itam_analyst
• system_administrator package extended with system properties and update set tools Full changelog

v2.1 highlights

• 4 new modules: Service Portal & UI Builder, Integration Hub, Notifications & Attachments, Performance Analytics
• Scripting enhancements — UI Policies, UI Actions, ACL management
• Reporting enhancements — scheduled job CRUD + run history
• Now Assist — generate_work_notes AI-drafted work notes for any record
• 2 new role packages — portal_developer, integration_engineer
• Binary file upload — uploadAttachment() via ServiceNow Attachment API

What's New in v2.0

• HRSD module — HR cases, services, profiles, onboarding/offboarding workflows
• CSM module — Customer cases, accounts, contacts, products, SLA tracking
• Security Operations & GRC — SecOps incidents, vulnerabilities, risks, controls, threat intel
• Flow Designer — List, inspect, trigger, and monitor flows and subflows
• OAuth 2.0 for all AI clients
• Role-based tool packages — persona-specific packages
• Now Assist Agentic Playbooks — AI automation
• ATF Failure Insight — test failure diagnostics
• 61 unit tests covering all permission tiers, routing, and domain handlers
• Complete documentation — reference guides in docs/

Documentation

Development

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

Project Structure

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

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

• Bug reports and feature requests: open an issue
• New tool domains, additional tests, or documentation improvements are especially appreciated
• All PRs require npm test to pass

Security

If you discover a security vulnerability, please follow the responsible disclosure process in SECURITY.md. Do not open a public issue.

Frequently Asked Questions

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 — Zurich, Yokohama, and Xanadu — 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 and open-source under the MIT license.

License

MIT — free for personal and commercial use.