ServiceNow-MCP
Summary: An MCP server that connects AI clients (Claude, Cursor, VS Code, etc.) to ServiceNow, exposing ~503 tools for reading and — when explicitly enabled — writing ITSM, CMDB, catalog, and platform data.
Read/query any ServiceNow table with filtering, field selection, sorting, pagination, plus schema inspection and single-record lookup.
Manage ITSM records end to end: incidents, problems, changes, tasks — create, update, add work notes or customer comments, resolve, close, and route for approval.
Work with the CMDB and ITOM: search CIs, inspect relationships, run impact analysis, view CMDB health, discovery schedules, MID servers, and infrastructure events.
Handle knowledge and service catalog: search/list KB articles and bases, create/update/publish/retire articles, browse and order catalog items, manage variables and UI policies.
Track requests and approvals: list sc_request / sc_req_item records, update or cancel them, view pending approvals, approve or reject.
Administer users and groups: list, create, update accounts and assignment groups, add or remove group members.
Report and analyze: saved reports, aggregate (COUNT/SUM/AVG) and time-bucketed trend queries, Performance Analytics widgets, KPIs, scheduled report delivery, and raw JSON exports.
Operate the platform: view system logs, list/inspect/create/update/trigger scheduled jobs, review job run history, and run ATF test suites.
Support multi-instance setups: list configured instances, switch the active instance, and check which one is current.
Offer experimental natural-language search and natural-language record updates.
Enforce tiered permissions: read-only by default, with writes gated behind env flags (WRITE_ENABLED, CMDB_WRITE_ENABLED, SCRIPTING_ENABLED, ATF_ENABLED) and OAuth 2.0 (client credentials or password grant) for authentication.
Run locally over stdio or Streamable HTTP with bearer-token auth, so no port or network setup is needed for standard use.
Integrates with GitHub Copilot to provide ServiceNow operations via natural language, enabling AI-assisted management of ITSM records, catalog items, and platform configuration.
Allows Google Gemini to communicate with ServiceNow through the MCP server, enabling natural language operations on incidents, changes, CMDB, and other ServiceNow data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ServiceNow-MCP Show me the latest 5 P1 incidents"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
/>_________________________________
[########[]_________________________________>
\>⛩️ servicenow-mcp ⛩️
⚔️ 武士道 (BUSHIDO) エディション ⚔️
AI から ServiceNow を自然言語で操作する MCP サーバー
ローカル PC で動作 · 503 ツール · 5 分セットアップ · MIT ライセンス
Claude・Cursor・VS Code などの AI ツールから、ServiceNow のインシデント・変更・CMDB・スクリプトなどをすべて自然言語で操作できます。
開発版(未リリース)
明示指定のAU-CL-006を追加。Client Scriptのg_formによる必須・表示・読取専用制御をUI Policy検討の候補にします。複雑な処理やUI制約を一律違反とせず、適合性を確認項目として返します。既定3規則・上限は維持、合成検証のみです。
明示指定のAU-CL-002を追加。Client ScriptのgetReference/GlideRecord get・queryを、受信側を区別した照会確認候補として返します。不要と断定せず、頻度・必要列・業務上の必要性を確認項目にします。実PDI検証は未実施です。
明示指定のAU-CL-008を追加。onChangeのClient Scriptで、読込フラグのガードと照会箇所を区別し、読込時にも必要かを確認する候補として返します。単なるisLoadingへの言及や別イベントを同一視せず、自動return追加はしません。合成検証のみです。
明示指定のAU-CL-003を追加。onLoadの取得入力を定数・実行時依存・情報不足に分け、可用性・鮮度・公開範囲の確認候補を返します。scratchpad移行を一律推奨せず、機密データ追加や自動移行は行いません。実PDI確認は未実施です。
明示指定のAU-CL-007を追加。Client Scriptの文書由来とcreateElement由来のDOM検索を区別し、標準UIか自作DOMかを決めつけず確認候補を返します。同名の独自メソッドを除外し、受信側不明は未解決として残します。自動削除・置換や実PDI確認は行っていません。
明示指定のAU-CL-005を追加。Client Scriptのg_form由来の2引数setValueを、独自メソッド・3引数呼出しと区別して確認候補にします。参照列・表示値の可用性・追加通信を断定せず、照会追加や引数の自動挿入はしません。実PDI確認は未実施です。
明示指定のAU-QRY-002を追加。BRの2引数addQueryと固定addEncodedQueryの全文検索条件を区別し、索引・検索設定の確認候補を返します。索引の有無・検索可否・違反は断定せず、索引作成やクエリ変更は実行しません。実PDI確認は未実施です。
明示指定のAU-BR-007を追加。保存値before_displayのBRでcurrentへの直接書込み・限定setterを確認候補にします。表示目的の変更を違反と断定せず、永続化要件を確認項目として返します。既定3規則・上限は維持、合成検証のみです。
明示指定のAU-BR-005を追加。before BRの中止後の呼出し・プロパティ書込みを、受信側・順序・早期return・if分岐を区別して候補化します。必要な後処理を違反と断定せず、未対応経路は未解決。既定3規則・上限は維持し、合成検証のみです。
明示指定のAU-BR-004を追加。BRのトップレベル変数候補を関数/ブロックlocalと区別し、共有の意図は確認項目として返します。Global-tableとglobal scopeを混同せず、自動除外や承認はしません。既定3規則は維持、今回の追加分は合成検証のみです。
AU-QRY-001を明示指定するBR限定のaddQueryレビューを追加。ローカルGlideRecord系の3引数・リテラルLIKEを候補化し、encoded queryのLIKEは対象外。未解決は制限として返します。既定3規則は維持し、今回の追加分は合成検証のみ・PDI未検証です。読み取り専用PoC
review_update_set_best_practicesを登録。AustraliaのUpdate Set payloadを対象に、3規則の候補と公式根拠を本文なしのJSONで返します。BR/Client Scriptの規則を評価するときはselection_mode=review_targetsを明示し、0.3 JSONの制限・取得範囲を確認してください。PDI対象選択E2Eは5成功・0スキップ:既存BR10件への解析到達と省略時の0.2互換性を確認しました。非アクティブ合成Client ScriptのE2EでもAU-CL-004の候補1件を確認しました。件数・受信量・全体60秒の上限は不変です。UI実行、人による規則承認・独立品質評価は未確認で、「安全」「違反確定」を意味しません。詳細は利用例・制限。
v1.13 ハイライト
Node.js 22.12 以上が必要です(v1.12.0〜)。Node 20 は 2026 年 4 月に EOL を迎えました。MCP クライアント設定の
commandが Node 22.12 以上を起動することを確認してくださいExcel 取り込み(
import_excel_to_import_set)を、外部ライブラリを使わない読み取り専用パーサに置き換え。インストール時の依存が 231 → 137 パッケージ・65 MB → 31 MB になり、npm auditは 0 件Excel 取り込みの改善: 空行より後の行も取り込む(従来は欠落)、ヘッダー行の数式は拒否、和暦など日本語の組み込み日付書式を日付として取り込む
stdio で起動したとき、
.envの読み込みメッセージが stdout に混ざってプロトコルを壊す問題を修正(v1.11.8)
v1.11.7 ハイライト
list_active_eventsは未処理イベント(Ready/Error)を新しい順に取得するよう改善。処理済みを含む全状態を検索する場合はstate: "all"を指定Smart Query・USEM・Now Assist メタデータ・ServiceNow Store の読み取り専用 E2E を追加。2026-09-26 の追加分は 21 件成功・4 件スキップ(対象データ不足)。AI 起動やレコード更新は実施していません
v1.11.6 までの主な変更
Update Set 内のスクリプト系 Customer Update から、固定バージョンの npm コンポーネントを検出し、OSV の advisory と照合する読み取り専用 SCA ツール
scan_update_set_scaを追加SCA は本文・payload・一致箇所を返さず、メタデータ・ハッシュ・PURL・証跡のみを返却。未解決参照や照会失敗を「脆弱性なし」と誤認しない JSON 契約を提供
Event Management のアラート一覧・詳細・集計・確認・クローズ・更新の 6 ツールを追加(
itom_engineerパッケージ)SOAP、Security Incident Response、脆弱性スキャン、バックグラウンドスクリプト実行、Agile Epic の実機で判明した不整合を修正
v1.11.6 で ExcelJS 配下の
uuidを固定しましたが、npm のoverridesはインストール先には適用されないため、利用者環境のnpm audit警告は v1.13.0 で ExcelJS を依存から外すまで残っていました
Related MCP server: snow-mcp
このツールが何をするか(初心者向け)
flowchart TD
subgraph PC["💻 あなたの PC"]
direction TB
AI["🤖 AI クライアント<br/>(Claude Desktop / Cursor / VS Code)"]
MCP["⚙️ servicenow-mcp サーバー<br/>(ここがこのツール)"]
AI <-->|"MCP プロトコル (stdio)"| MCP
end
SN["☁️ ServiceNow インスタンス<br/>(開発 PDI または 社内環境)"]
MCP <-->|"HTTPS / REST API<br/>(インターネット経由)"| SN
style PC fill:#f0f7ff,stroke:#00509E,stroke-width:2px,color:#333,stroke-dasharray: 5 5
style AI fill:#ffffff,stroke:#333,stroke-width:2px,color:#000
style MCP fill:#e6ffe6,stroke:#008000,stroke-width:2px,color:#000
style SN fill:#fff0f0,stroke:#cc0000,stroke-width:2px,color:#000ポイント:
サーバーは あなたの PC 上で動く Node.js プロセスです。通常のツールは ServiceNow とだけ通信します。SCA の OSV 脆弱性照会など、外部連携を行うツールは個別に明示します
AI クライアントと stdio(標準入出力)で通信するため、ポート開放やネットワーク設定は不要
ServiceNow へは HTTPS で接続します。既存のブラウザアクセスと同じ経路です
推奨環境
まずは開発インスタンス (PDI) でお試しください。
本番環境への接続は技術的には可能ですが、AI の誤操作・意図しないレコード更新を防ぐため、
はじめは読み取り専用モード (WRITE_ENABLED=false) で動作を確認してから本番適用してください。
環境 | 推奨度 | 注意 |
PDI (無料開発インスタンス) | ★★★ 推奨 | 無料。操作の影響なし。初めて使う方はここから |
社内開発・検証インスタンス | ★★☆ 可 | チームと共有している場合は読み取り専用で開始 |
本番インスタンス | ★☆☆ 要注意 |
|
無料 PDI → developer.servicenow.com
動作の仕組み
sequenceDiagram
participant U as あなた
participant AI as AI クライアント<br/>(Claude / Cursor)
participant MCP as servicenow-mcp<br/>(ローカル PC)
participant SN as ServiceNow<br/>(クラウド)
U->>AI: 「P1 インシデントを一覧表示して」
AI->>MCP: list_incidents(priority=1) を呼び出す
MCP->>MCP: 権限チェック (読み取りは常に許可)
MCP->>SN: GET /api/now/table/incident?sysparm_query=priority=1
SN-->>MCP: JSON でインシデント一覧を返す
MCP-->>AI: ツール結果を返す
AI-->>U: 「現在 3 件の P1 インシデントがあります...」はじめての方向け — 5 分セットアップ
flowchart TD
A([はじめる]) --> B{ServiceNow\nインスタンスはある?}
B -->|ない| C[developer.servicenow.com\nで無料 PDI を取得\n約 10 分]
B -->|ある| D
C --> D{Node.js 22.12+\nインストール済み?}
D -->|ない| E[nodejs.org から\nLTS 版をインストール]
E --> F
D -->|あり| F[ターミナルでコマンド実行]
F --> G["npm install -g @tedorigawa001/servicenow-mcp"]
G --> H["servicenow-mcp setup"]
H --> I{セットアップ\nウィザード}
I --> J[インスタンス URL を入力\n例: https://dev12345.service-now.com]
J --> K[OAuth グラントタイプを選択\nclient_credentials または password]
K --> L[OAuth 認証情報を入力]
L --> M[接続テスト]
M -->|失敗| N[URL・認証情報を確認]
N --> L
M -->|成功| O[AI クライアントを自動検出]
O --> P[設定ファイルを自動書き込み]
P --> Q([完了!\nAI から ServiceNow に繋がります])ステップ 1 — インストール
方法 A: npm からインストール(推奨・最速)
# Node.js のバージョン確認 (22.12 以上が必要)
node --version
# グローバルインストール
npm install -g @tedorigawa001/servicenow-mcp
# セットアップウィザードを起動
servicenow-mcp setup方法 B: ソースからビルド(開発・カスタマイズしたい方向け)
# リポジトリをクローン
git clone https://github.com/tedorigawa001/ServiceNow-MCP.git
cd ServiceNow-MCP
# 依存パッケージのインストール & コンパイル
npm install
npm run build
# セットアップウィザードを起動
npm run setupどちらの方法でも、ウィザードが Claude Desktop・Cursor・VS Code などを自動検出し、設定ファイルを自動で書き込みます(VS Code は npx ... server 起動 + シークレットは inputs 化、それ以外は dist/server.js の絶対パス)。
ステップ 2 — AI クライアントを再起動
設定ファイルを書き込んだあと、Claude Desktop や Cursor を 一度完全に終了して再起動 してください。
ステップ 3 — 動作確認
AI に話しかけてみましょう:
「ServiceNow に接続して、直近のインシデントを 5 件表示してください」Docker での起動
ソースビルド vs Docker — どちらを選ぶか
比較項目 | ソースビルド( | Docker( |
起動速度 | ✅ 即時 | ⚠️ コンテナ起動分のオーバーヘッドあり |
設定のシンプルさ | ⚠️ 絶対パスが必要 | ✅ |
環境依存 | Node.js 22.12+ が必要 | Docker が必要 |
環境の統一 | ⚠️ ホスト環境に依存 | ✅ どの PC でも同一環境 |
チーム配布・CI/CD | ⚠️ 各自でビルドが必要 | ✅ イメージを共有するだけ |
推奨シーン | 個人利用・開発 | チーム配布・本番運用 |
イメージのビルドと起動
# イメージをビルド
docker build -t servicenow-mcp .
# 起動
docker run --rm -i \
-e SERVICENOW_INSTANCE_URL=https://yourinstance.service-now.com \
-e SERVICENOW_OAUTH_CLIENT_ID=your_client_id \
-e SERVICENOW_OAUTH_CLIENT_SECRET=your_client_secret \
servicenow-mcpPassword Grant を使う場合は、さらに以下を追加します:
-e SERVICENOW_OAUTH_USERNAME=service_account_user \
-e SERVICENOW_OAUTH_PASSWORD=service_account_password \AI クライアントから接続する(Claude Desktop)
claude_desktop_config.json の command / args を以下のように変更します。
Client Credentials を使う場合は SERVICENOW_OAUTH_USERNAME と SERVICENOW_OAUTH_PASSWORD の 2 行を省略してください。
{
"mcpServers": {
"servicenow": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "SERVICENOW_INSTANCE_URL=https://yourinstance.service-now.com",
"-e", "SERVICENOW_OAUTH_CLIENT_ID=your_client_id",
"-e", "SERVICENOW_OAUTH_CLIENT_SECRET=your_client_secret",
"-e", "SERVICENOW_OAUTH_USERNAME=service_account_user",
"-e", "SERVICENOW_OAUTH_PASSWORD=service_account_password",
"servicenow-mcp"
]
}
}
}注意:
-iフラグは必須です。MCP は stdio(標準入出力)で通信するため、インタラクティブモードが必要です。
HTTP モードで起動する場合: コンテナ内の既定バインドは
127.0.0.1のため公開ポートからは到達できません。-e MCP_TRANSPORT=http -e MCP_HTTP_HOST=0.0.0.0 -p 3000:3000を付与してください。 イメージは非 root(nodeユーザー)で動作し、EXPOSE 3000済みです。
認証方式(OAuth 2.0 のみ)
このサーバーは OAuth 2.0 のみ をサポートします。Basic Auth はセキュリティリスク(資格情報が平文で設定ファイルに残る)があるため廃止しました。
OAuth 2.0 には 2 種類のグラントタイプがあり、用途に応じて自動選択されます。
flowchart TD
START([OAuth 設定]) --> Q1{ユーザー名/パスワードを\n設定する?}
Q1 -->|しない| CC["Client Credentials Grant\ngrant_type=client_credentials\n\nclient_id + client_secret のみ\n推奨: サービス間連携・自動化"]
Q1 -->|する| PW["Password Grant\ngrant_type=password\n\nclient_id + client_secret\n+ username + password\n既存ユーザー権限を引き継ぎたい場合"]
CC --> CC_NOTE["ServiceNow が Application Registry 上の\nスコープで API を実行する"]
PW --> PW_NOTE["指定ユーザーの権限でAPIを実行する\n(ACL・ロールがそのまま適用)"]Client Credentials(推奨)
client_id と client_secret だけで動作します。ユーザー資格情報が不要なため、サービス間連携に最適です。
SERVICENOW_INSTANCE_URL=https://dev12345.service-now.com
SERVICENOW_OAUTH_CLIENT_ID=your_client_id
SERVICENOW_OAUTH_CLIENT_SECRET=your_client_secretPassword Grant(ユーザー権限を引き継ぐ場合)
特定ユーザーの ACL・ロールで API を実行したい場合に使います。
SERVICENOW_INSTANCE_URL=https://dev12345.service-now.com
SERVICENOW_OAUTH_CLIENT_ID=your_client_id
SERVICENOW_OAUTH_CLIENT_SECRET=your_client_secret
SERVICENOW_OAUTH_USERNAME=svc_mcp
SERVICENOW_OAUTH_PASSWORD=your_passwordOAuth セットアップ手順
OAuth は ServiceNow の管理者権限が必要です。PDI では自分で設定できます。
ServiceNow 側の設定
Step 1 — OAuth アプリケーションレジストリを作成
ServiceNow にログイン
左メニューで「Application Registry」を検索
「New」→ 「New Inbound Integration Experience」 を選択
⚠️ 「[Deprecated UI] Create an OAuth API endpoint for external clients」は旧 UI です。
現行バージョンでは New Inbound Integration Experience を使用してください。
グラントタイプによって設定が異なります。
Client Credentials Grant(推奨)
重要: Client Credentials Grant では ServiceNow 側でユーザーを指定する必要があります。
これは標準 OAuth の仕様とは異なる ServiceNow 固有の要件です。
アクセストークンは「どのユーザーとして API を実行するか」を ServiceNow が決定するために使用します。
Name: servicenow-mcp
Token Format: JWT ← 必須
Client ID: (自動生成)
Client Secret: (自動生成 → コピーして保存)
Redirect URL: http://localhost
Access Token Lifespan: 1800 (秒)
Default Grant user: svc_mcp ← 必須: API を実行するサービスアカウントを指定Default Grant user に指定したユーザーの ロール・ACL が API 実行時に適用されます。
このユーザーには必要最小限の ServiceNow ロール(例: itil, admin 等)を付与してください。
Password Grant
Name: servicenow-mcp
Token Format: JWT ← 必須
Client ID: (自動生成)
Client Secret: (自動生成 → コピーして保存)
Redirect URL: http://localhost
Access Token Lifespan: 1800 (秒)
Default Grant user: (不要 — username/password で指定したユーザーが使われます)「Submit」で保存。
Step 2 — 生成された Client ID / Secret を確認
作成したレジストリを開き、Client ID と Client Secret をメモします。
flowchart LR
A[Application Registry を開く] --> B[Client ID をコピー]
A --> C[Client Secret をコピー\nShow をクリック]
B & C --> D[環境変数に設定]MCP サーバー側の設定
Client Credentials Grant
SERVICENOW_INSTANCE_URL=https://dev12345.service-now.com
SERVICENOW_OAUTH_CLIENT_ID=your_client_id
SERVICENOW_OAUTH_CLIENT_SECRET=your_client_secret
# SERVICENOW_OAUTH_USERNAME / PASSWORD は不要Password Grant
SERVICENOW_INSTANCE_URL=https://dev12345.service-now.com
SERVICENOW_OAUTH_CLIENT_ID=your_client_id
SERVICENOW_OAUTH_CLIENT_SECRET=your_client_secret
SERVICENOW_OAUTH_USERNAME=svc_mcp
SERVICENOW_OAUTH_PASSWORD=your_password接続確認:
node dist/cli/index.js auth testAI クライアント別セットアップ
Claude Desktop
設定ファイル: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"servicenow": {
"command": "node",
"args": ["/path/to/servicenow-mcp/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://dev12345.service-now.com",
"SERVICENOW_OAUTH_CLIENT_ID": "your_client_id",
"SERVICENOW_OAUTH_CLIENT_SECRET": "your_client_secret",
"WRITE_ENABLED": "false"
}
}
}
}
WRITE_ENABLED: "false"にしておくと読み取り専用になります。動作確認が終わったら"true"に変更できます。
ユーザー権限を引き継ぐ場合はSERVICENOW_OAUTH_USERNAMEとSERVICENOW_OAUTH_PASSWORDも追加してください。
Claude Code CLI
claude mcp add servicenow node /path/to/servicenow-mcp/dist/server.js \
--env SERVICENOW_INSTANCE_URL=https://dev12345.service-now.com \
--env SERVICENOW_OAUTH_CLIENT_ID=your_client_id \
--env SERVICENOW_OAUTH_CLIENT_SECRET=your_client_secret \
--env WRITE_ENABLED=falseCursor
設定ファイル: .cursor/mcp.json
{
"mcpServers": {
"servicenow": {
"command": "node",
"args": ["/path/to/servicenow-mcp/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://dev12345.service-now.com",
"SERVICENOW_OAUTH_CLIENT_ID": "your_client_id",
"SERVICENOW_OAUTH_CLIENT_SECRET": "your_client_secret",
"WRITE_ENABLED": "true",
"SCRIPTING_ENABLED": "true"
}
}
}
}VS Code (1.99+)
設定ファイル: .vscode/mcp.json(ワークスペースルート)
.vscode/ はコミットされがちなので、シークレットは平文で書かず VS Code の inputs(初回起動時にプロンプト表示・暗号化保存)に逃がします。セットアップウィザードもこの形式で書き込みます。
{
"inputs": [
{
"type": "promptString",
"id": "servicenow-client-secret",
"description": "ServiceNow OAuth client secret",
"password": true
}
],
"servers": {
"servicenow-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@tedorigawa001/servicenow-mcp", "server"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://dev12345.service-now.com",
"SERVICENOW_OAUTH_CLIENT_ID": "your_client_id",
"SERVICENOW_OAUTH_CLIENT_SECRET": "${input:servicenow-client-secret}"
}
}
}
}対応クライアント一覧
クライアント | 種別 | ガイド |
Claude Desktop | デスクトップ | |
Claude Code CLI | ターミナル | |
Cursor | AI エディタ | |
Windsurf | AI エディタ | |
VS Code (Native MCP 1.99+) | IDE | |
VS Code + GitHub Copilot | IDE | |
VS Code + Continue.dev | IDE | |
VS Code + Cline | IDE | |
JetBrains AI | IDE | |
Amazon Q Developer | IDE / CLI | |
ChatGPT / OpenAI API | API | |
Google Gemini API | API | |
Ollama (ローカル LLM) | ローカル |
全クライアントのセットアップ詳細 → docs/CLIENT_SETUP.md
トランスポート(stdio / HTTP)
デフォルトは stdio(標準入出力)で、ポート開放やネットワーク設定は不要です。 ブラウザ経由の接続(Claude.ai Web UI)、Docker コンテナ公開、複数クライアントでのサーバー共有、 CI/CD からの呼び出しが必要な場合は Streamable HTTP トランスポートに切り替えられます。
# HTTP トランスポートで起動(トークンはランダムな十分長い値を使用)
MCP_TRANSPORT=http MCP_HTTP_AUTH_TOKEN=replace-with-a-random-secret node dist/server.js
# → http://127.0.0.1:3000/mcp で待ち受け、GET /health でヘルスチェック環境変数 | デフォルト | 説明 |
|
|
|
|
| 待ち受けポート |
|
| バインドアドレス(外部公開時は |
|
| MCP エンドポイントのパス |
| (必須) | MCP エンドポイント用 Bearer トークン。未設定時は |
|
| CORS 許可オリジン |
| (なし) | カンマ区切り。指定すると DNS リバインディング保護を有効化 |
| (なし) | カンマ区切り。Origin ヘッダの許可リスト |
|
| JSON-RPC 要求本文の最大バイト数 |
|
| 同時 HTTP MCP セッションの上限 |
|
| 未使用セッションを閉じるまでのミリ秒 |
セッションは MCP 仕様に従い、initialize 応答の Mcp-Session-Id ヘッダで払い出され、
以降のリクエストで再利用します(DELETE /mcp でセッション終了)。HTTP 接続するクライアント設定例:
{
"mcpServers": {
"servicenow": {
"url": "http://localhost:3000/mcp",
"headers": { "Authorization": "Bearer replace-with-a-random-secret" }
}
}
}セキュリティ注意: HTTP MCP は
MCP_HTTP_AUTH_TOKENを必須とします。デフォルトは loopback(127.0.0.1)バインドです。MCP_HTTP_HOST=0.0.0.0で外部公開する場合は、リバースプロキシでの TLS 終端・認証、およびMCP_HTTP_ALLOWED_HOSTS/MCP_HTTP_ALLOWED_ORIGINSによる保護を推奨します。
権限設定(何ができるかを制御する)
デフォルトは読み取り専用です。操作範囲を広げたい場合は環境変数で段階的に有効化します。
graph TD
T0["🛡️ Tier 0: 常時有効 (デフォルト)<br/>インシデント表示 / KB 検索 / レコード参照..."]
T1["✏️ Tier 1: WRITE_ENABLED=true<br/>インシデント作成・更新 / 変更リクエスト管理..."]
T2["🧩 Tier 2: CMDB_WRITE_ENABLED=true (Tier 1も必要)<br/>CI の作成・更新 / 関連付け管理..."]
T3["⚙️ Tier 3: SCRIPTING_ENABLED=true (Tier 1も必要)<br/>ビジネスルール / スクリプト / Update Set..."]
TAI["🤖 Tier AI: NOW_ASSIST_ENABLED=true<br/>NLQ / AI サマリー / Agentic Playbook..."]
T0 --> T1
T1 --> T2
T1 --> T3
T0 -.->|"独立オプション"| TAI
style T0 fill:#f5f5f5,stroke:#999,stroke-width:2px,color:#333
style T1 fill:#e3f2fd,stroke:#2196f3,stroke-width:2px,color:#000
style T2 fill:#fff3e0,stroke:#ff9800,stroke-width:2px,color:#000
style T3 fill:#ffebee,stroke:#f44336,stroke-width:2px,color:#000
style TAI fill:#f3e5f5,stroke:#9c27b0,stroke-width:2px,color:#000本番環境で使う場合の推奨設定:
WRITE_ENABLED=false # まずは読み取りのみで確認
CMDB_WRITE_ENABLED=false
SCRIPTING_ENABLED=false # 本番では原則 false のままロールベース ツールパッケージ
MCP_TOOL_PACKAGE 環境変数でツールを絞り込めます。全部入りではなく、用途に応じたセットを使うと AI が迷わずに済みます。
mindmap
root((ツールパッケージ))
full
全503ツール
service_desk
インシデント管理
タスク/承認
KB検索
SLA確認
change_coordinator
変更管理
CABスケジュール
CMDB参照
platform_developer
スクリプト管理
ACL/UI Policy
ATFテスト
Update Set
system_administrator
ユーザー/グループ管理
レポート/ログ
PA ダッシュボード
itom_engineer
CMDB
Discovery
MIDサーバー
ai_developer
Now Assist
NLQ
Agentic Playbooks
secops_analyst
VI作成/RT横断検索
グルーピング診断
SLA/例外承認パッケージ名 | 対象ロール | 主なツール |
| 管理者 | 全ツール (503) |
| L1/L2 エージェント | インシデント・タスク・KB・SLA |
| 変更管理者 | 変更リクエスト・CAB・CMDB |
| KB 著者 | KB 作成・公開 |
| カタログ管理者 | カタログ・承認ルール |
| システム管理者 | ユーザー・グループ・レポート |
| 開発者 | スクリプト・ATF・Update Set |
| ポータル開発者 | ポータル・ウィジェット・UX |
| 統合エンジニア | REST・Transform・イベント |
| ITOM エンジニア | CMDB・Discovery(実行履歴/エラー調査)・MID ヘルス・ACC・Event Management アラート管理 |
| スクラムマスター | ストーリー・エピック |
| AI 開発者 | Now Assist・NLQ・Playbook |
| 資産管理者 | 資産・ライセンス・契約・SAM Pro(ソフトウェア資産管理) |
| SecOps アナリスト | 脆弱性(VI/RT)・RT横断検索・グルーピング診断・USEM・SLA・例外承認 |
| DevOps | パイプライン・デプロイ |
使用例
自然言語で操作する
「Network Operations グループの P1 インシデントをすべて表示して」
「INC0012345 に "調査中。30 分以内に更新します" とワークノートを追加して」
「SAP 本番システムの障害でインシデントを作成して。
優先度 Critical、Network Ops グループに割り当てて」
「先月の Priority 別インシデント件数をグラフ用データで出して」典型的なやりとりの流れ
sequenceDiagram
participant U as あなた
participant AI as AI アシスタント
participant MCP as servicenow-mcp
participant SN as ServiceNow
U->>AI: 「SAP の P1 インシデントを作って」
AI->>MCP: create_incident を呼び出す
MCP->>MCP: WRITE_ENABLED チェック ✅
MCP->>SN: POST /api/now/table/incident
SN-->>MCP: INC0099001 作成完了
MCP-->>AI: 作成結果を返す
AI-->>U: 「INC0099001 を作成しました」
U->>AI: 「SAP サーバーの CMDB 依存関係も確認して」
AI->>MCP: search_cmdb_ci + list_relationships
MCP->>SN: CMDB API を 2 回呼び出す
SN-->>MCP: 依存 CI 8 件
MCP-->>AI: 依存関係リスト
AI-->>U: 「SAP-PROD-DB01 は 8 つの CI に依存しています」Update Set の第三者コンポーネントを SCA する
scan_update_set_sca は 読み取り専用で Update Set 内のスクリプト系 Customer Update を収集し、固定バージョンが確認できる npm コンポーネントを検出します。既定では OSV に照会して advisory を JSON で返します。コード本文・payload・一致箇所の文字列は返しません。
「Release 1.12 Update Set を SCA スキャンして。検出したコンポーネント、
脆弱性、照会できなかった項目、次の対応を JSON の根拠だけで報告して」ローカル収集だけを先に確認したい場合は、AI に lookup_vulnerabilities: false を指定します。
{
"update_set": "46f0...",
"max_records": 50,
"lookup_vulnerabilities": false
}AI への報告依頼例:
scan_update_set_sca の JSON だけを根拠に報告してください。
critical / high を最優先にし、各 finding は component、installed_version、
advisory_id、fixed_versions、evidence の asset_type と asset_name を示してください。
summary.assessment、lookup.status、errors、unresolved_references、truncated を必ず確認し、
対象外・未照会・失敗を「脆弱性なし」と表現しないでください。
修正は自動実行せず、Update Set の変更案と確認手順を提案してください。制約:
findingsが空でも安全性は証明されません。バージョン範囲、latestのような CDN alias、バージョンなしのモジュール参照は CVE 照合できずunresolved_referencesとして返ります。CDN URL を検出しても、そのライブラリが実際にロード・実行されたことまでは示しません。また SCA は依存コンポーネントを対象にするものであり、ServiceNow のカスタムスクリプトに対する SAST、権限設計、クエリ安全性のレビューを代替しません。
スラッシュコマンド & @メンション
/morning-standup → P1/P2 オープンインシデント・当日変更・SLA 違反のサマリー
/my-tickets → 自分に割り当てられたオープンタスク一覧
/p1-alerts → アクティブな P1 インシデント一覧
@my-incidents → 自分のインシデントをコンテキストに追加
@ci:web-prod-01 → CMDB CI レコードをコンテキストに追加
@kb:VPN-setup → KB 記事をコンテキストに追加120+ の実例 → EXAMPLES.md
マルチインスタンス対応
graph LR
User["あなたの PC\n(AI + MCP サーバー)"] -->|dev| DEV[(開発 PDI\ndev12345.service-now.com)]
User -->|staging| STG[(検証\nstg.company.com)]
User -->|prod| PRD[(本番\nacme.service-now.com)]{
"default_instance": "dev",
"instances": {
"dev": {
"url": "https://dev12345.service-now.com",
"client_id": "dev-client-id",
"client_secret": "dev-client-secret"
},
"prod": {
"url": "https://acme.service-now.com",
"auth": "oauth",
"client_id": "xxx",
"client_secret": "yyy",
"username": "svc_account",
"password": "zzz"
}
}
}SN_INSTANCES_CONFIG=/path/to/instances.jsonモジュールカバレッジ
graph TB
subgraph ITSM["ITSM & サービス管理"]
I1[インシデント管理]
I2[問題管理]
I3[変更管理]
I4[タスク管理]
I5[ナレッジベース]
I6[サービスカタログ]
end
subgraph PLATFORM["プラットフォーム & 開発"]
P1[スクリプト/ビジネスルール]
P2[Flow Designer]
P3[Service Portal / UIB]
P4[ATF テスト]
P5[Update Set 管理]
P6[App Studio]
end
subgraph OPS["運用 & 分析"]
O1[CMDB / ITOM]
O2[Performance Analytics]
O3[レポート / 集計]
O4[通知 / 添付]
O5[システムプロパティ]
O6[DevOps パイプライン]
O7[インスタンス診断 / 性能履歴]
end
subgraph EXTENDED["拡張モジュール"]
E1[HRSD]
E2[CSM]
E3[SecOps / GRC]
E4[Agile / Scrum]
E5[IT 資産管理]
E6[Virtual Agent]
end
subgraph AI["AI & インテグレーション"]
A1[Now Assist / AI]
A2[Integration Hub]
A3[Machine Learning]
A4[モバイル]
A5[ワークスペース]
endプロジェクト構造
servicenow-mcp/
├── src/
│ ├── server.ts # MCP サーバーエントリーポイント
│ ├── servicenow/
│ │ ├── client.ts # REST API クライアント (OAuth)
│ │ ├── instances.ts # マルチインスタンスマネージャー
│ │ └── types.ts # TypeScript 型定義
│ ├── tools/ # 47 ドメインモジュール (503 ツール)
│ │ ├── index.ts # ツールルーター & パッケージ定義
│ │ ├── incident.ts
│ │ ├── change.ts
│ │ ├── knowledge.ts
│ │ └── ...
│ ├── prompts/ # スラッシュコマンド定義
│ ├── resources/ # @メンション定義
│ ├── cli/ # セットアップウィザード
│ └── utils/
│ ├── permissions.ts # 5 段階権限ゲート
│ └── errors.ts
├── tests/ # 通常テスト・実機 E2E (Vitest)
├── docs/ # ドキュメント
└── instances.example.json開発
npm install # 依存パッケージのインストール
npm run build # TypeScript → dist/ にコンパイル
npm test # 通常テストを実行(実機 E2E は別途 opt-in)
npm run dev # ウォッチモード
npm run type-check # 型チェックのみ
npm run lint # ESLint実機 E2E の検証範囲
追加の読み取り専用 E2E(2026-09-26)は、4 スイート・25 ケース中 21 件成功、4 件スキップです。 スキップは VI/RT/グループの対象レコード不足による詳細取得テストで、成功件数には含めていません。 Now Assist はメタデータ取得のみで、AI 推論・生成・プレイブック起動は未検証です。
MCP登録時点のE2Eコード静的集計記録は **241/503 ツール(約47.9%)**です(今回追加した試験を含む全体対象数の再集計ではありません)。
ベストプラクティスレビューは今回、実機の取得/集約2件成功・payload解析1件スキップで、詳細は検証記録を参照してください。
これはコード行・分岐のカバレッジや、全241ツールの実機成功率を示す数値ではありません。
テスト件数は変更されるため、通常テストの最新件数は npm test の実行結果を参照してください。
PDI と OAuth を設定したうえで、今回の読み取り専用スイートだけを実行する例:
RUN_E2E=true WRITE_ENABLED=false SCRIPTING_ENABLED=false \
npx vitest run -c vitest.e2e.config.ts \
tests/e2e/smart-query.e2e.test.ts \
tests/e2e/usem-read.e2e.test.ts \
tests/e2e/now-assist-read.e2e.test.ts \
tests/e2e/store-read.e2e.test.tsNow Assist メタデータのテストは NOW_ASSIST_ENABLED=true の場合のみ実行します。
不足するプラグイン・テストデータは理由付きでスキップし、API/ACL エラーは失敗として扱います。
詳細は E2E 検証記録 と CONTRIBUTING.md を参照してください。
よくある質問
ServiceNow の API 知識は必要ですか?
いいえ。「P1 インシデントを一覧表示して」のように日本語で話しかけるだけです。API 呼び出しはサーバーが自動で行います。
本番環境に接続しても大丈夫ですか?WRITE_ENABLED=false(デフォルト)で接続する分には読み取りのみで安全です。書き込みを有効にする前に、必ず開発環境で動作を確認してください。
無料で使えますか?
このサーバー自体は MIT ライセンスで無料です。ServiceNow の無料 PDI(Personal Developer Instance)も developer.servicenow.com で取得できます。AI クライアント側(Claude Pro 等)の料金は各サービスに従います。
MCP って何ですか?
Model Context Protocol の略で、AI クライアントが外部ツールを呼び出すための標準規格です。Claude・Cursor などが対応しています。このサーバーは MCP に準拠しているため、対応 AI から自動的に発見・使用されます。
複数インスタンスに接続できますか?
はい。instances.json で dev / staging / prod を定義しておき、「本番インスタンスに切り替えて」と指示するだけで切り替わります。
ドキュメント
ガイド | 内容 |
環境変数リファレンス | |
全 AI クライアントのセットアップ | |
ServiceNow OAuth アプリ作成手順(詳細版) | |
ロールベースパッケージの詳細 | |
全ツールのパラメータ・権限要件 | |
マルチインスタンス設定 | |
Now Assist / AI 統合 | |
ATF テストガイド | |
120+ 実用例 | |
セキュリティポリシー・脆弱性報告 | |
変更履歴 |
コントリビュート
CONTRIBUTING.md をお読みの上、Pull Request をお送りください。
バグ報告・機能要望 → Issue を開く
セキュリティ
脆弱性を発見した場合は 公開 Issue には投稿せず、SECURITY.md の責任ある開示プロセスに従ってください。
ライセンス
MIT — 個人・商用利用とも無料。
503 ツール · 47 モジュール · ローカル PC で動作 · 永久オープンソース
役に立ったら ⭐ スターをお願いします — 他の人が見つけやすくなります。
Available Tools
503 toolsacknowledge_alertAIdempotent
Acknowledge an alert (sets acknowledged=true, exactly like the "Acknowledge" list action), optionally with a work note. Already-acknowledged alerts are reported, not re-written. [Write]
Inputs: number_or_sysid (required), work_notes.
act_on_vr_approvalA
Approve or reject a Vulnerability Response approval (sysapproval_approver) by sys_id, which advances the attached workflow and transitions the underlying VR record. Rejection requires a comment. [Write — requires WRITE_ENABLED=true]
Inputs: action (required), sys_id (required), comments.
add_commentA
Add a customer-visible comment to any ITSM record (requires WRITE_ENABLED=true)
Inputs: table (required), sys_id (required), comment (required).
add_user_to_groupA
Add a user to a group (requires WRITE_ENABLED=true)
Inputs: user_sys_id (required), group_sys_id (required).
add_vi_to_remediation_taskA
Associate a Vulnerable Item with a remediation group via the "Remediation Task Item" m2m (sn_vul_m2m_vul_group_item). The group is an sn_vul_vulnerability record that backs the remediation task. [Write — requires WRITE_ENABLED=true]
Inputs: vulnerable_item (required), remediation_group (required).
add_work_noteA
Add an internal work note to any ITSM record (requires WRITE_ENABLED=true)
Inputs: note (required), table (required), sys_id (required).
ai_searchARead-onlyIdempotent
Semantic AI-powered search across KB, catalog, incidents (ServiceNow AI Search)
Inputs: query (required), limit, sources.
analyze_data_qualityARead-onlyIdempotent
Analyse data quality for a table — completeness, duplicates, stale records
Inputs: table (required), days_stale, required_fields.
approve_requestAIdempotent
Approve a pending approval request (requires WRITE_ENABLED=true)
Inputs: sys_id (required), comments.
bulk_get_propertiesB
Retrieve multiple system property values in a single call
Inputs: names (required).
bulk_set_propertiesAIdempotent
Create or update multiple system properties in a single operation. [Write]
Inputs: properties (required).
cancel_requestADestructive
Cancel an open service catalog request (requires WRITE_ENABLED=true)
Inputs: sys_id (required), comments.
categorize_incidentARead-onlyIdempotent
Use Predictive Intelligence to predict category, assignment group, and priority (latest release: LightGBM algorithm)
Inputs: short_description (required), description.
check_app_upgradeARead-onlyIdempotent
Compare the installed version of a scoped app (from sys_scope on the instance) against the public Store version history, and return the release notes of every newer version. For upgrade planning of Store apps (VR, ACC Framework, ...), whose lifecycle is independent of platform upgrades. Provide either listing_id, or store_query / nothing to search by app name.
Inputs: scope (required), max_newer, listing_id, store_query, +1 more.
check_table_accessARead-onlyIdempotent
Diagnose the connected service account's effective access to one or more tables BEFORE attempting operations. Returns per-table readable/writable flags plus a status that distinguishes WHY access failed: "not_installed" (Invalid table — the table does not exist, e.g. plugin/app not installed), "no_access" (403 — table exists but ACL denies this account), "empty" (readable but zero rows — truly empty or ACL row filtering), or "accessible". Also returns the account's current user and assigned roles. Read is probed with a sysparm_limit=1 GET; write is probed non-destructively with an empty PATCH to a reserved all-zero sys_id (404=writable, 403=denied) — no record is ever created or modified. Useful to check whether a plugin is installed and to avoid "User Not Authorized" retries.
Inputs: tables (required), check_write.
check_table_completenessBRead-onlyIdempotent
Analyze data quality and field completeness for a ServiceNow table — returns percentage of non-empty values per field
Inputs: table (required), fields (required), query, sample_size.
clone_artifactA
Clone a platform artifact to a new name/scope. [Scripting]
Inputs: table (required), sys_id (required), new_name (required), target_scope.
close_alertADestructive
Close an alert (state=Closed, like the "Close" action; also acknowledges it when evt_mgmt.alert_ack_on_close is true), optionally with a work note. Refuses alerts that are already Closed. [Write]
Inputs: number_or_sysid (required), work_notes.
close_change_requestADestructive
Close a change request with close code and notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), close_code (required), close_notes (required).
close_csm_caseADestructive
Close a CSM case with resolution details (requires WRITE_ENABLED=true)
Inputs: sys_id (required), resolution_notes (required), resolution_code.
close_hr_caseADestructive
Close an HR case with resolution notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), close_notes (required), close_code.
close_incidentADestructive
Close a resolved incident (requires WRITE_ENABLED=true)
Inputs: sys_id (required).
cmdb_health_dashboardARead-onlyIdempotent
Get CMDB data quality metrics (completeness of server and network CI data)
Inputs: no named parameters.
cmdb_impact_analysisB
Analyze the downstream impact of a Configuration Item change or outage
Inputs: ci_sys_id (required), depth.
commit_changesetADestructive
Commit an update set (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
compare_record_countsBRead-onlyIdempotent
Compare record counts across multiple ServiceNow tables or time periods — useful for capacity planning
Inputs: tables (required), query.
complete_taskAIdempotent
Mark a task as complete (requires WRITE_ENABLED=true)
Inputs: sys_id (required), close_notes.
complete_update_setCIdempotent
Mark an Update Set as complete (ready for migration). [Scripting]
Inputs: sys_id (required).
configure_offline_syncCIdempotent
UNSUPPORTED: offline configuration requires a validated Mobile App Builder workflow. No state-table writes are performed. [Write]
Inputs: table (required), query, max_records.
configure_workspace_listAIdempotent
Create a legacy sys_aw_list configuration under an existing Agent Workspace. query maps to the condition column. Does not update existing lists or configure UX lists. [Write]
Inputs: table (required), title (required), workspace_sys_id (required), query, +1 more.
create_aclA
Create a new ACL rule to control access to a table or field (requires SCRIPTING_ENABLED=true)
Inputs: name (required), operation (required), type, roles, +4 more.
create_approval_ruleA
Create an approval rule that automatically generates approval requests when a record matches given conditions (requires WRITE_ENABLED=true). Uses the sysapproval_rule table.
Inputs: name (required), table (required), approver (required), approver_type (required), +3 more.
create_archive_ruleA
Create an inactive archive rule under an existing Data Management Policy. retain_references can only be chosen at creation. [Write]
Inputs: name (required), condition (required), policy_sys_id (required), description, +2 more.
create_assetB
Create a new IT asset record. [Write]
Inputs: display_name (required), cost, model, location, +6 more.
create_business_ruleA
Create a new business rule (requires SCRIPTING_ENABLED=true). ServiceNow supports ES2021 async/await in scripts.
Inputs: name (required), when (required), table (required), script (required), +6 more.
create_catalog_itemA
Create a new service catalog item (requires WRITE_ENABLED=true)
Inputs: name (required), short_description (required), price, roles, +4 more.
create_catalog_ui_policyA
[Write] Create a UI policy for a catalog item form
Inputs: cat_item_id (required), short_description (required), conditions, reverse_if_false.
create_catalog_variableA
[Write] Add a form variable to a service catalog item
Inputs: name (required), type (required), cat_item_id (required), question_text (required), +2 more.
create_change_requestB
Create a new change request (requires WRITE_ENABLED=true)
Inputs: type (required), short_description (required), risk, impact, +11 more.
create_ci_relationshipC
[CMDB Write] Create a relationship between two CMDB Configuration Items
Inputs: type (required), child (required), parent (required).
create_cleanup_ruleB
Create an inactive Table Cleanup Rule for a Data Management Policy. It deletes live records only after explicit activation. [Write]
Inputs: condition (required), age_seconds (required), policy_sys_id (required), clean_audit, +3 more.
create_client_scriptA
Create a new client script (onLoad, onChange, onSubmit, onCellEdit) (requires SCRIPTING_ENABLED=true)
Inputs: name (required), type (required), table (required), script (required), +3 more.
create_compliance_controlB
Create a Compliance Control (sn_compliance_control). implementation_statement is dictionary-mandatory on this table but not enforced by the REST API (it is left blank if omitted) — pass it to describe how the control is actually implemented. [Write — requires WRITE_ENABLED=true]
Inputs: name (required), owner, profile, category, +4 more.
create_compliance_policyA
Create a Compliance Policy (sn_compliance_policy). kb_knowledge_base, approval_method, and article_template are dictionary-mandatory on this table; the platform silently defaults them (to the standard policy KB / "manual" approval / the standard article template) if omitted, so omitting them will NOT fail the create — but pass them explicitly if you need a specific knowledge base, approval method, or template. [Write — requires WRITE_ENABLED=true]
Inputs: name (required), owner, category, description, +5 more.
create_csm_caseA
Create a new Customer Service case (requires WRITE_ENABLED=true)
Inputs: short_description (required), account, contact, product, +5 more.
create_dashboardA
Create a new Performance Analytics dashboard (requires WRITE_ENABLED=true)
Inputs: name (required), roles, active, description.
create_data_management_policyB
Create an inactive Data Management Policy. Existing policies for the table are rejected. [Write]
Inputs: name (required), table (required), description.
create_destroy_ruleB
Create an inactive destroy rule for archived data. retention_days must be at least one day. [Write]
Inputs: name (required), retention_days (required), archive_rule_sys_id (required), description, +1 more.
create_devops_changeA
Create a change request linked to a DevOps deployment for change governance. [Write]
Inputs: environment (required), short_description (required), type, artifact, +3 more.
create_epicB
Create a new epic (requires WRITE_ENABLED=true)
Inputs: short_description (required), theme, product, description, +1 more.
create_flowB
Create a new Flow Designer flow. [Write]
Inputs: name (required), scope, description, trigger_type, +1 more.
create_flow_actionA
Create a custom Flow Designer action. [Scripting]
Inputs: name (required), inputs, script, outputs, +1 more.
create_grc_entityA
Create a GRC Entity (sn_grc_profile). profile_class must be a valid sys_id from sn_grc_profile_class (e.g. Business Unit, Vendor, Application — use list_grc_entities with no filter or query_records on sn_grc_profile_class to discover valid classes). owned_by is dictionary-mandatory but not enforced by the REST API (the Entity is created with no owner if omitted) — set it to avoid an unowned Entity. [Write — requires WRITE_ENABLED=true]
Inputs: name (required), profile_class (required), cmdb_ci, owned_by, +3 more.
create_grc_indicatorA
Create a GRC Indicator (sn_grc_indicator). item is the sys_id of an EXISTING Compliance Control (sn_compliance_control) or Risk (sn_risk_risk) record — both extend the same base table, so their own sys_id is used directly, no separate lookup needed. entity MUST be the specific Entity already associated with that item (e.g. the Control/Risk's own profile field) — confirmed live that a validation business rule rejects (HTTP 403) any entity that isn't the one the item is actually scoped to. [Write — requires WRITE_ENABLED=true]
Inputs: item (required), entity (required), owner, category, +3 more.
create_grc_issueC
Create a GRC Issue (sn_grc_issue). [Write — requires WRITE_ENABLED=true]
Inputs: short_description (required), impact, profile, urgency, +4 more.
create_groupA
Create a new assignment group (requires WRITE_ENABLED=true)
Inputs: name (required), manager, description.
create_hr_caseB
Create a new HR Service Delivery case (requires WRITE_ENABLED=true)
Inputs: hr_service (required), short_description (required), priority, description, +2 more.
create_hr_taskA
Create a task within an HR case (requires WRITE_ENABLED=true)
Inputs: hr_case_sysid (required), short_description (required), due_date, assigned_to.
create_import_set_rowA
Insert a row into an Import Set staging table (a table extending sys_import_set_row) for later transformation (requires WRITE_ENABLED=true)
Inputs: data (required), staging_table (required), import_set_sys_id (required).
create_incidentA
Create a new incident record (requires WRITE_ENABLED=true)
Inputs: short_description (required), impact, urgency, category, +5 more.
create_knowledge_articleB
Create a new knowledge article (requires WRITE_ENABLED=true)
Inputs: text (required), short_description (required), knowledge_base_sys_id (required), category.
create_kpiC
[Write] Create a Key Performance Indicator from ServiceNow data
Inputs: name (required), table (required), aggregate (required), unit, +2 more.
create_mobile_app_configA
Create a name-only sys_sg_mobile_application metadata record. Does not provision an installable mobile app, branding, navigation or screens. [Write]
Inputs: name (required).
create_mobile_appletB
Create base sys_sg_screen metadata only. Does not configure a screen subtype, data item, navigation or app association. [Write]
Inputs: name (required), description.
create_mobile_layoutB
Link an existing screen to an existing UI element. Creates only an M2M mapping, not a full layout or screen. [Write]
Inputs: screen_sys_id (required), ui_element_sys_id (required).
create_notificationA
Create a new email notification definition (requires WRITE_ENABLED=true)
Inputs: name (required), table (required), event, active, +4 more.
create_offboarding_caseB
Create an employee offboarding case with exit tasks. [Write]
Inputs: last_day (required), employee_sys_id (required), reason, manager.
create_onboarding_caseA
Create an employee onboarding case with all standard tasks. [Write]
Inputs: start_date (required), employee_sys_id (required), manager, location, +2 more.
create_portalA
Create a new Service Portal configuration (requires WRITE_ENABLED=true)
Inputs: title (required), url_suffix (required), logo, theme, +2 more.
create_portal_pageA
Create a new page inside a Service Portal (requires WRITE_ENABLED=true)
Inputs: id (required), title (required), portal_sys_id (required), description.
create_portal_widgetA
Create a new Service Portal widget with template, CSS, and scripts (requires WRITE_ENABLED=true and SCRIPTING_ENABLED=true)
Inputs: id (required), name (required), css, template, +4 more.
create_problemB
Create a new problem record (requires WRITE_ENABLED=true)
Inputs: short_description (required), priority, description, assignment_group.
create_remediation_taskB
Create a Remediation Task (sn_vul_remediation_task). [Write — requires WRITE_ENABLED=true]
Inputs: short_description (required), state, cmdb_ci, assigned_to, +4 more.
create_reportA
Create a new saved report on any table (requires WRITE_ENABLED=true)
Inputs: type (required), table (required), title (required), field, +4 more.
create_rest_messageA
Create a new outbound REST Message definition (requires WRITE_ENABLED=true)
Inputs: name (required), endpoint (required), description, use_mutual_auth, +1 more.
create_riskA
Create a Risk (sn_risk_risk). NOTE: impact/likelihood/score are NOT settable here — confirmed live that a business rule always overwrites them regardless of client input (see list_risk_criteria to inspect the scale; scoring appears to require the platform's risk assessment workflow, not direct field writes). [Write — requires WRITE_ENABLED=true]
Inputs: statement (required), profile, category, owning_group.
create_scheduled_jobA
Create a new scheduled script execution job (requires WRITE_ENABLED=true)
Inputs: name (required), script (required), run_type (required), active, +2 more.
create_scheduled_reportB
[Write] Schedule a report for recurring email delivery
Inputs: frequency (required), report_id (required), recipients (required), format, +2 more.
create_scoped_appA
Create a new scoped application in App Studio (requires WRITE_ENABLED=true). The scope prefix must be unique and follow the pattern x__.
Inputs: name (required), scope (required), logo, active, +4 more.
create_script_includeA
Create a new script include (requires SCRIPTING_ENABLED=true)
Inputs: name (required), script (required), access, active, +1 more.
create_scrum_taskA
Create a scrum task (sub-task of a story) (requires WRITE_ENABLED=true)
Inputs: short_description (required), assigned_to, story_sys_id.
create_security_incidentA
Create a Security Operations incident (requires WRITE_ENABLED=true)
Inputs: category (required), short_description (required), severity, description, +3 more.
create_soap_messageA
Create a new outbound SOAP Message definition in sys_soap_message (requires WRITE_ENABLED=true). The endpoint URL is set per function via create_soap_message_function.
Inputs: name (required), wsdl, description, authentication_type.
create_soap_message_functionA
Add a SOAP function (operation) to an existing SOAP Message in sys_soap_message_function (requires WRITE_ENABLED=true)
Inputs: function_name (required), soap_message_sys_id (required), envelope, soap_action, +1 more.
create_solution_packageB
Create a solution package from selected update sets for distribution. [Write]
Inputs: name (required), update_sets (required), description.
create_storyA
Create a new agile story/user story (requires WRITE_ENABLED=true)
Inputs: short_description (required), epic, sprint, assigned_to, +2 more.
create_subflowB
Create a new reusable subflow. [Write]
Inputs: name (required), scope, inputs, description.
create_ui_actionA
Create a new UI Action (button or link) on a form (requires SCRIPTING_ENABLED=true)
Inputs: name (required), table (required), action_name (required), type, +5 more.
create_uib_componentB
Create a custom UI Builder component (macroponent). [Scripting]
Inputs: name (required), label (required), category, description.
create_uib_data_brokerB
Create a UI Builder data broker to feed data to a page. [Scripting]
Inputs: name (required), table (required), page, query.
create_uib_pageA
Create a new UI Builder page with route registration. [Write]
Inputs: path (required), title (required), app, layout.
create_ui_policyA
Create a new UI Policy to control field behavior dynamically (requires SCRIPTING_ENABLED=true)
Inputs: table (required), short_description (required), active, script, +2 more.
create_update_setA
Create a new Update Set and optionally switch to it. [Scripting]
Inputs: name (required), release, switch_to, description.
create_usem_ruleA
Create a USEM/VR automation rule. Provide the rule_type and a fields object matching that table allowlist (e.g. name/rule_name, active, order, condition, assignment_group, ttr_max). Every field is read back after the write; a value ServiceNow did not store fails with FIELDS_NOT_SAVED. remediation_task with assignment_type 5 (Group by field) also needs assignment_group_fields — a field path on the finding that matches one of field_1..6 (e.g. "assignment_group"). The Table API cannot write that field, so it is set by a run-once server script and additionally requires SCRIPTING_ENABLED=true. Create rules inactive and enable them with set_usem_rule_active after checking them. [Write — requires WRITE_ENABLED=true; admin-level config change]
Inputs: fields (required), rule_type (required), wait_seconds.
create_userA
Create a new user account (requires WRITE_ENABLED=true)
Inputs: email (required), last_name (required), user_name (required), first_name (required), +2 more.
create_ux_app_routeC
Register a new route (URL path) in a UX app. [Write]
Inputs: path (required), app_sys_id (required), page_sys_id (required), title.
create_ux_experienceB
Create a new UX Experience (app shell) configuration. [Write]
Inputs: name (required), app_sys_id (required), landing_page.
create_va_topicC
Create a new Virtual Agent conversation topic. [Write]
Inputs: name (required), active, category, description, +1 more.
create_vulnerability_groupA
Create a Vulnerability Group / Remediation Task (sn_vul_vulnerability). Being task-based it accepts assignment_group, assigned_to and state. [Write — requires WRITE_ENABLED=true]
Inputs: short_description (required), state, assigned_to, description, +2 more.
create_vulnerable_itemA
Create a Vulnerable Item (sn_vul_vulnerable_item) with the vulnerability reference intact. A before business rule clears the vulnerability reference on REST inserts, which silently disables the "Link to Remediation Tasks" automation; this tool re-applies the reference via PATCH after insert and verifies it stuck. Requires both vulnerability and cmdb_ci so the remediation-task rule engine can group the item. ServiceNow regenerates short_description as " detected on " on insert, so a value passed here cannot be used to tag items or to select them later (e.g. in a remediation task rule condition) — use source instead; the result reports overwritten fields. [Write — requires WRITE_ENABLED=true]
Inputs: cmdb_ci (required), vulnerability (required), state, source, +4 more.
create_workspaceA
Create inactive legacy Agent Workspace metadata only. Does not provision a Configurable Workspace or its pages. Configure lists separately. [Write]
Inputs: name (required), workspace_url (required), description.
delete_attachmentADestructive
Delete an attachment from a record (requires WRITE_ENABLED=true)
Inputs: attachment_sys_id (required).
delete_system_propertyADestructive
Delete a system property by name. [Write]
Inputs: name (required).
delete_uib_pageBDestructive
Delete a UI Builder page. [Write]
Inputs: sys_id (required).
describe_tableARead-onlyIdempotent
Return full field schema for a ServiceNow table using sys_dictionary — includes field types, reference targets, mandatory/unique flags, and parent table. More accurate than get_table_schema for empty tables or custom tables.
Inputs: table (required), include_inherited.
ensure_active_update_setAIdempotent
Ensure an active Update Set exists; create one automatically if none is in progress. [Scripting]
Inputs: default_name.
execute_background_scriptADestructive
Run server-side JavaScript on the instance and return what it returns. The script runs in the global scope inside a run-once Scheduled Script Execution (ServiceNow has no REST endpoint that runs scripts synchronously), so it executes when the instance scheduler picks the job up, normally within seconds. End the script with return <value>; to get a value back (JSON-serialisable; max ~3.5 KB). [Scripting]
Inputs: script (required), wait_seconds.
export_propertiesARead-onlyIdempotent
Export system properties matching a query to a JSON object (useful for environment snapshots)
Inputs: query, category.
export_report_dataBRead-onlyIdempotent
Export raw table data as structured JSON for use in external reports
Inputs: table (required), limit, query, fields.
export_update_setBRead-onlyIdempotent
Get the XML export payload for an Update Set (as used in migration). [Scripting]
Inputs: sys_id (required).
find_artifactARead-onlyIdempotent
Search for platform artifacts by name, type, or scope (business rules, scripts, widgets, etc.)
Inputs: name (required), type, limit, scope.
fire_eventA
Fire a custom ServiceNow event for a specific record (requires WRITE_ENABLED=true)
Inputs: table (required), event_name (required), record_sys_id (required), parm1, +1 more.
generate_summaryBRead-onlyIdempotent
Generate an AI summary of any record using Now Assist (latest release: sn_assist/skill/summarize)
Inputs: table (required), sys_id (required).
generate_work_notesB
Generate AI-drafted work notes for a record based on its current context
Inputs: table (required), sys_id (required), context.
get_aclARead-onlyIdempotent
Get full details of an ACL rule including its script and role requirements (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_alertARead-onlyIdempotent
Get one alert by number or sys_id, with its recent history (em_alert_history) and related tasks (incident/change/problem links).
Inputs: number_or_sysid (required), history_limit.
get_alert_summaryARead-onlyIdempotent
Operational overview of open alerts: counts by severity, by state, acknowledged vs not, and the top sources. Read-only.
Inputs: top_sources, include_closed.
get_archive_restore_statusBRead-onlyIdempotent
Get the restore status of one archive log entry, including whether its primary record is live or archived.
Inputs: archive_log_sys_id (required).
get_assetARead-onlyIdempotent
Get full details of an IT asset including financial and lifecycle data
Inputs: sys_id (required).
get_atf_failure_insightARead-onlyIdempotent
Get ATF Failure Insight data — metadata changes between last successful and failed run (role changes, field value changes)
Inputs: result_sys_id (required).
get_atf_suiteARead-onlyIdempotent
Get details of a test suite including test count
Inputs: sys_id_or_name (required).
get_atf_suite_resultBRead-onlyIdempotent
Get the results of a test suite run
Inputs: result_sys_id (required).
get_atf_testARead-onlyIdempotent
Get details of a specific test case
Inputs: sys_id (required).
get_attachment_metadataARead-onlyIdempotent
Get metadata (name, type, size) of a specific attachment by its sys_id
Inputs: attachment_sys_id (required).
get_audit_control_testARead-onlyIdempotent
Get full details of a single Control Test by sys_id or number (e.g. "CTR0000153").
Inputs: number_or_sysid (required).
get_audit_engagementARead-onlyIdempotent
Get full details of a single Audit Engagement by sys_id or number (e.g. "ENG0000104").
Inputs: number_or_sysid (required).
get_business_ruleARead-onlyIdempotent
Get full details and script body of a business rule (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_catalog_itemARead-onlyIdempotent
Get full details of a catalog item including its variables
Inputs: sys_id_or_name (required).
get_change_requestARead-onlyIdempotent
Get full details of a change request by number (CHG...) or sys_id
Inputs: number_or_sysid (required).
get_changesetARead-onlyIdempotent
Get details of an update set (requires SCRIPTING_ENABLED=true)
Inputs: sys_id_or_name (required).
get_client_scriptARead-onlyIdempotent
Get full details and script body of a client script (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_cmdb_ciBRead-onlyIdempotent
Get complete information about a specific configuration item
Inputs: ci_sys_id (required), fields.
get_compliance_controlARead-onlyIdempotent
Get full details of a single Compliance Control by sys_id or number (e.g. "CTRL0020012").
Inputs: number_or_sysid (required).
get_compliance_policyARead-onlyIdempotent
Get full details of a single Compliance Policy by sys_id or number (e.g. "POL0010200").
Inputs: number_or_sysid (required).
get_control_objectiveBRead-onlyIdempotent
Get full details of a single Control Objective by sys_id.
Inputs: sys_id (required).
get_csm_accountARead-onlyIdempotent
Get details of a customer account including contacts and open cases count
Inputs: name_or_sysid (required).
get_csm_caseARead-onlyIdempotent
Get full details of a CSM case by number (e.g. CS0001234) or sys_id
Inputs: number_or_sysid (required).
get_csm_case_slaARead-onlyIdempotent
Get SLA details and remaining time for a CSM case
Inputs: case_sysid (required).
get_csm_contactARead-onlyIdempotent
Get details of a customer contact (name, account, phone, email)
Inputs: name_or_sysid (required).
get_current_instanceARead-onlyIdempotent
Get the currently active ServiceNow instance name and URL
Inputs: no named parameters.
get_current_update_setARead-onlyIdempotent
Get the currently active Update Set for the session
Inputs: no named parameters.
get_data_management_policyCRead-onlyIdempotent
Get a Data Management Policy and the archive rules for its table.
Inputs: sys_id (required).
get_deploymentARead-onlyIdempotent
Get details and status of a specific deployment
Inputs: sys_id (required).
get_devops_insightsARead-onlyIdempotent
Get deployment frequency, failure rate, and lead time metrics for a pipeline
Inputs: days, pipeline_sys_id.
get_devops_pipelineARead-onlyIdempotent
Get details of a specific DevOps pipeline
Inputs: sys_id (required).
get_discovery_runBRead-onlyIdempotent
Get one Discovery run by sys_id or number (DIS...), including full status fields
Inputs: run_id (required).
get_email_logARead-onlyIdempotent
Get full details of an email log entry including body and headers
Inputs: sys_id (required).
get_event_registry_entryARead-onlyIdempotent
Get details of a specific registered event definition
Inputs: name_or_sysid (required).
get_finding_grouping_statusARead-onlyIdempotent
Diagnose why a Vulnerable Item is (not) grouped into a Remediation Task. Returns the VI's grouping preconditions (vulnerability and cmdb_ci references, is_in_group), its m2m links with each task's auto_vi_refresh, the active remediation task rules (sn_sec_rem_task_rule), and an ordered diagnosis: empty vulnerability → no active rule → rule/condition mismatch or auto_vi_refresh=false on the existing task.
Inputs: vulnerable_item (required).
get_flowARead-onlyIdempotent
Get full details of a Flow Designer flow including its actions and trigger
Inputs: name_or_sysid (required).
get_flow_error_logARead-onlyIdempotent
Get detailed error logs for failed flow executions
Inputs: flow_sys_id (required), days, limit.
get_flow_executionARead-onlyIdempotent
Get the status and details of a specific flow execution
Inputs: execution_sysid (required).
get_grc_audit_dashboardARead-onlyIdempotent
Summarize the Audit Management posture: Engagement counts by state, Control Test counts by design/operation effectiveness, and the highest-priority-issue open engagements.
Inputs: top.
get_grc_compliance_dashboardARead-onlyIdempotent
Summarize the Compliance posture: Policy/Control/Issue counts by state, and the highest-risk open Policy Exceptions.
Inputs: top.
get_grc_entityARead-onlyIdempotent
Get full details of a single GRC Entity by sys_id.
Inputs: sys_id (required).
get_grc_indicatorARead-onlyIdempotent
Get full details of a single GRC Indicator by sys_id or number (e.g. "IND0020021").
Inputs: number_or_sysid (required).
get_grc_indicator_dashboardARead-onlyIdempotent
Summarize Indicator posture: counts by category and by last-result pass/fail.
Inputs: no named parameters.
get_grc_issueARead-onlyIdempotent
Get full details of a single GRC Issue by sys_id or number (e.g. "IPT0011010").
Inputs: number_or_sysid (required).
get_grc_risk_dashboardARead-onlyIdempotent
Summarize the Risk posture: Risk counts by state, and the highest-scored open risks.
Inputs: top.
get_groupARead-onlyIdempotent
Find assignment group details by name or sys_id
Inputs: group_identifier (required).
get_group_slaARead-onlyIdempotent
Get both SLA views for a task-based Vulnerability Group (sn_vul_vulnerability) by VUL number or sys_id: the built-in TTR status (target date, breach, days remaining) AND any attached task_sla instances (definition, stage, breached, percentage, time left). Use this for groups; VI/RT (which are not task-based) use get_remediation_sla.
Inputs: number_or_sysid (required).
get_hr_caseARead-onlyIdempotent
Get full details of an HR case by number (e.g. HRCS0001234) or sys_id
Inputs: number_or_sysid (required).
get_hr_case_activityARead-onlyIdempotent
Get the full activity log and journal entries for an HR case
Inputs: hr_case_sysid (required).
get_hr_lifecycle_eventsARead-onlyIdempotent
Get HR lifecycle events for an employee (promotions, transfers, leaves)
Inputs: employee_sys_id (required), limit, event_type.
get_hr_profileARead-onlyIdempotent
Get the HR profile for a user (employment details, department, manager)
Inputs: user_identifier (required).
get_hr_serviceARead-onlyIdempotent
Get details of a specific HR service including its tasks and SLAs
Inputs: sys_id_or_name (required).
get_import_setARead-onlyIdempotent
Get details of a specific Import Set including row count and transform status
Inputs: sys_id (required).
get_incidentARead-onlyIdempotent
Get full details of an incident by number (e.g. INC0012345) or sys_id
Inputs: number_or_sysid (required).
get_indicator_resultARead-onlyIdempotent
Get full details of a single Indicator Result by sys_id.
Inputs: sys_id (required).
get_instance_diagnosticsARead-onlyIdempotent
Get live instance performance diagnostics: JVM memory, semaphore pools (concurrency/queue depth), and cluster node status — the data behind the Performance homepage (/stats.do)
Inputs: include, raw_xml, all_nodes.
get_integration_healthARead-onlyIdempotent
Report the health of Vulnerability Response data integration runs (sn_vul_integration_run) over a recent window. Surfaces failed runs and — critically — silent stalls where no runs occurred at all (e.g. an NVD/Qualys feed quietly failing with 503/429). Returns success/failure counts, the most recent success and failure timestamps, recent run details, and actionable alerts.
Inputs: days, source.
get_integration_runARead-onlyIdempotent
Get full detail of a single Vulnerability Integration Run by run number (VINTRUNxxxx) or sys_id, including performance metrics and any fatal_error_message.
Inputs: number_or_sysid (required).
get_knowledge_articleARead-onlyIdempotent
Get the full content of a knowledge article by number (KB...) or sys_id
Inputs: number_or_sysid (required).
get_license_complianceARead-onlyIdempotent
Get license compliance summary — purchased vs. installed vs. in use counts
Inputs: license_sys_id.
get_license_optimizationBRead-onlyIdempotent
Analyze software license usage and recommend optimizations
Inputs: software_name, threshold_pct.
get_license_position_summaryARead-onlyIdempotent
Aggregate license-compliance dashboard: over-licensed vs. under-licensed counts, total potential savings, total true-up cost
Inputs: publisher.
get_mid_server_healthARead-onlyIdempotent
MID Server health summary — status, version, last refresh, open issues, extension contexts (web server / ACC listener), and output-queue backlog sample
Inputs: mid_server (required).
get_mobile_analyticsARead-onlyIdempotent
UNSUPPORTED: no validated mobile session telemetry source is configured. Returns an error rather than invented usage counts.
Inputs: days.
get_mobile_app_configARead-onlyIdempotent
Get details of a specific mobile app configuration
Inputs: sys_id (required).
get_ms_copilot_topicsARead-onlyIdempotent
List VA topics exposed to Microsoft Copilot 365 via Custom Engine Agent integration
Inputs: limit.
get_my_approvalsARead-onlyIdempotent
List approvals pending for the currently configured user
Inputs: state.
get_notificationARead-onlyIdempotent
Get full details of an email notification definition including template and conditions
Inputs: sys_id_or_name (required).
get_nvd_entry_by_cveARead-onlyIdempotent
Look up a single NVD entry by exact CVE id (e.g. "CVE-2018-1002203").
Inputs: cve (required).
get_pa_dashboardARead-onlyIdempotent
Get details of a PA dashboard including its widgets/tabs
Inputs: sys_id_or_name (required).
get_pa_indicatorARead-onlyIdempotent
Get details of a specific Performance Analytics indicator including its formula
Inputs: sys_id_or_name (required).
get_pa_jobBRead-onlyIdempotent
Get details of a Performance Analytics collection job
Inputs: sys_id (required).
get_pa_scorecardARead-onlyIdempotent
Get current scorecard data for a PA indicator — returns current value, target, trend direction
Inputs: indicator_sys_id (required), period, include_scores, breakdown_sys_id.
get_pa_time_seriesBRead-onlyIdempotent
Get historical time-series data for a PA indicator to identify trends
Inputs: indicator_sys_id (required), limit, end_date, start_date.
get_performance_analyticsBRead-onlyIdempotent
Get Performance Analytics widget data (requires PA plugin; latest release: /api/now/pa/widget/{sys_id})
Inputs: widget_sys_id (required), time_range.
get_performance_historyARead-onlyIdempotent
Get historical transaction performance as a time series (transaction count, avg/max response time, SQL time, business rule time per bucket) from the transaction log — chartable data for instance performance trends, replacing the legacy Performance dashboard graphs
Inputs: hours, query, buckets, group_by_node.
get_pi_modelsARead-onlyIdempotent
List available Predictive Intelligence solutions (classification/similarity models)
Inputs: no named parameters.
get_policy_exceptionBRead-onlyIdempotent
Get full details of a single Policy Exception by sys_id or number (e.g. "PER0000106").
Inputs: number_or_sysid (required).
get_portalARead-onlyIdempotent
Get full configuration details of a Service Portal by sys_id or URL suffix
Inputs: id (required).
get_portal_pageBRead-onlyIdempotent
Get details of a specific Service Portal page including its layout
Inputs: sys_id (required).
get_portal_themeARead-onlyIdempotent
Get full details of a Service Portal theme including CSS variables
Inputs: sys_id (required).
get_portal_widgetARead-onlyIdempotent
Get full source code (HTML, CSS, client/server scripts) of a Service Portal widget
Inputs: id_or_sysid (required).
get_problemARead-onlyIdempotent
Get full details of a problem by number (PRB...) or sys_id
Inputs: number_or_sysid (required).
get_process_automationCRead-onlyIdempotent
Get details of a Process Automation Designer playbook or process
Inputs: name_or_sysid (required).
get_property_historyARead-onlyIdempotent
Get audit history of changes to a system property
Inputs: name (required), limit.
get_recordARead-onlyIdempotent
Retrieve complete details of a specific record by sys_id
Inputs: table (required), sys_id (required), fields.
get_remediation_slaARead-onlyIdempotent
Get the SLA (TTR) detail for a single Vulnerable Item, Remediation Task, or Vulnerability Group by number or sys_id: status, target date, applied rule, breach flag and days remaining/overdue. For task-based Vulnerability Groups, task_sla instances are also available via get_sla_details.
Inputs: record_type (required), number_or_sysid (required).
get_remediation_taskARead-onlyIdempotent
Get full details of a single Remediation Task by sys_id or number. Looks in both backing tables: a VUL-prefixed number targets sn_vul_vulnerability (the rule-engine RT), anything else is tried as task_number on sn_vul_remediation_task first, then as number on sn_vul_vulnerability. The result includes a source_table marker.
Inputs: number_or_sysid (required).
get_reportARead-onlyIdempotent
Get the definition and metadata of a saved report
Inputs: sys_id_or_name (required).
get_requestARead-onlyIdempotent
Get a service catalog request (sc_request) by number or sys_id, including its requested items
Inputs: number_or_sysid (required).
get_request_itemARead-onlyIdempotent
Get a requested item (sc_req_item) by number or sys_id, including its fulfillment tasks
Inputs: number_or_sysid (required).
get_rest_messageARead-onlyIdempotent
Get full configuration of an outbound REST Message including its endpoints
Inputs: sys_id_or_name (required).
get_riskARead-onlyIdempotent
Get full details of a single Risk by sys_id or number (e.g. "RK0020310").
Inputs: number_or_sysid (required).
get_risk_calculator_detailsARead-onlyIdempotent
Explain how a USEM Risk Calculator computes its score: returns the calculator group (sn_sec_calculator_group), its calculator rules, each rule’s weighted risk fields (sn_sec_calculator_risk_field), and the score→weight bands for the target table (sn_sec_calculator_risk_score_weight) in one call. Use this to answer "why is the risk score N?". Accepts a sys_id or exact calculator name.
Inputs: calculator (required).
get_risk_statementARead-onlyIdempotent
Get full details of a single Risk Statement by sys_id.
Inputs: sys_id (required).
get_scheduled_jobARead-onlyIdempotent
Get full details of a scheduled job by sys_id or name
Inputs: sys_id_or_name (required).
get_scoped_appARead-onlyIdempotent
Get full details of a scoped application by sys_id or scope name
Inputs: id (required).
get_script_includeARead-onlyIdempotent
Get full script body of a script include (requires SCRIPTING_ENABLED=true)
Inputs: sys_id_or_name (required).
get_security_dashboardARead-onlyIdempotent
Get security posture dashboard — open incidents by severity, vulnerability counts, mean time to resolve
Inputs: days.
get_security_incidentARead-onlyIdempotent
Get full details of a security incident by number or sys_id
Inputs: number_or_sysid (required).
get_sla_detailsARead-onlyIdempotent
Get SLA breach status for a specific task or incident
Inputs: task_sys_id (required).
get_soap_messageARead-onlyIdempotent
Get full configuration of a SOAP Message including its functions/operations
Inputs: sys_id_or_name (required).
get_software_installBRead-onlyIdempotent
Get full details of a discovered software installation
Inputs: sys_id (required).
get_software_lifecycle_reportARead-onlyIdempotent
Get full lifecycle report details for one product (all phase dates, CVE breakdown, owners)
Inputs: sys_id (required).
get_software_modelARead-onlyIdempotent
Get full details of a software model (rights, consumption rules, EOL date, lifecycle stage)
Inputs: sys_id (required).
get_store_app_versionsARead-onlyIdempotent
Get version history with release notes (new features / bug fixes) for a Store app from the public Store API. Release notes are not stored in any instance table — this is the only programmatic source. Use search_store_apps to find the listing_id.
Inputs: listing_id (required), limit, include_notes.
get_subflowARead-onlyIdempotent
Get full details of a subflow including its inputs, outputs, and actions
Inputs: name_or_sysid (required).
get_sys_logARead-onlyIdempotent
Retrieve system log entries for debugging or auditing
Inputs: limit, query.
get_system_propertyARead-onlyIdempotent
Get a ServiceNow system property value and metadata by name
Inputs: name (required).
get_table_record_countARead-onlyIdempotent
Get total record count for a ServiceNow table with optional filters
Inputs: table (required), query.
get_table_schemaARead-onlyIdempotent
Get the structure and field information for a ServiceNow table
Inputs: table (required).
get_taskARead-onlyIdempotent
Get details of any task record by number or sys_id
Inputs: number_or_sysid (required).
get_threat_intelligenceARead-onlyIdempotent
Query threat intelligence data — IOCs, threat actors, and campaigns
Inputs: query (required), type, limit.
get_transform_mapARead-onlyIdempotent
Get details of a Transform Map including its field mappings
Inputs: sys_id_or_name (required).
get_ui_actionARead-onlyIdempotent
Get full details and script of a UI Action (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_uib_pageARead-onlyIdempotent
Get details of a specific UI Builder page including layout and child elements
Inputs: sys_id (required).
get_ui_policyARead-onlyIdempotent
Get full details and conditions of a UI Policy (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
get_usem_dashboardARead-onlyIdempotent
Summarize the USEM posture: Vulnerable Item counts by state, Remediation Task counts by state, and the highest-risk open Vulnerable Items. Uses the aggregate (stats) API for exact counts.
Inputs: top.
get_usem_ruleARead-onlyIdempotent
Get the full definition of a single USEM/VR rule by sys_id.
Inputs: sys_id (required), rule_type (required).
get_userBRead-onlyIdempotent
Look up user details by email or username
Inputs: user_identifier (required).
get_ux_appARead-onlyIdempotent
Get configuration details of a Next Experience application
Inputs: sys_id_or_name (required).
get_va_conversationARead-onlyIdempotent
Get conversation history for a Virtual Agent session
Inputs: conversation_id (required), limit.
get_va_topicBRead-onlyIdempotent
Get Virtual Agent topic details including intent and trigger phrases
Inputs: sys_id (required).
get_virtual_agent_topicsBRead-onlyIdempotent
List Virtual Agent topics available in the instance (latest release: streaming VA API)
Inputs: limit, active, category.
get_vulnerabilityARead-onlyIdempotent
Get details of a specific vulnerability entry including CVSS score and affected CIs
Inputs: number_or_sysid (required).
get_vulnerability_groupBRead-onlyIdempotent
Get full details of a single Vulnerability Group by sys_id or VUL number (e.g. "VUL0000103").
Inputs: number_or_sysid (required).
get_vulnerable_itemBRead-onlyIdempotent
Get full details of a single Vulnerable Item by sys_id or VI number (e.g. "VIT0010003").
Inputs: number_or_sysid (required).
get_workspaceBRead-onlyIdempotent
Get a legacy Agent Workspace definition and up to 50 of its sys_aw_list configurations
Inputs: sys_id (required).
import_cmdb_dataB
Import CI data into CMDB CI classes using a safe field allowlist. [CMDB Write]
Inputs: data (required), table (required).
import_excel_to_import_setA
Upload and parse one .xlsx worksheet, create an Import Set, insert its staging rows, and optionally request a Transform Map run (transform start is not verified). Requires WRITE_ENABLED=true. The original workbook is attached to the Import Set for auditability; formulas and sys_* columns are rejected.
Inputs: file_name (required), staging_table (required), content_base64 (required), sheet_name, +3 more.
import_propertiesA
Import (create or update) system properties from a JSON object. [Write]
Inputs: properties (required), dry_run.
list_acc_agentsARead-onlyIdempotent
List ACC (Agent Client Collector) agents and their status. Requires the ACC plugin
Inputs: limit, query, status.
list_acc_checksBRead-onlyIdempotent
List ACC check definitions. Requires the ACC plugin
Inputs: limit, query.
list_acc_policiesARead-onlyIdempotent
List ACC monitoring/check policies. Requires the ACC plugin
Inputs: limit, active.
list_aclsARead-onlyIdempotent
List Access Control rules (ACLs) — who can read/write/create/delete records (requires SCRIPTING_ENABLED=true)
Inputs: limit, table, active, operation.
list_action_instancesBRead-onlyIdempotent
List reusable Flow Designer action instances available in the environment
Inputs: limit, query, category.
list_active_eventsARead-onlyIdempotent
List Event Management events (em_event), newest first. Defaults to unprocessed events (state Ready or Error); pass state "all" for every event. For the alerts operators act on, use list_alerts.
Inputs: limit, query, state.
list_active_slasARead-onlyIdempotent
List active SLA records with optional filters
Inputs: limit, query.
list_alertsARead-onlyIdempotent
List Event Management alerts (em_alert) with operational filters. Defaults to alerts that are not Closed, most severe first.
Inputs: limit, query, state, source, +6 more.
list_approvalsARead-onlyIdempotent
List approval requests with optional filters
Inputs: limit, query, state.
list_archive_rulesBRead-onlyIdempotent
List archive rules, optionally for one exact table.
Inputs: limit, table.
list_asset_contractsBRead-onlyIdempotent
List asset maintenance and support contracts
Inputs: limit, active, asset_sys_id.
list_assetsBRead-onlyIdempotent
List IT assets with optional filtering by state, class, or assigned user
Inputs: limit, query, state, location, +2 more.
list_atf_suitesARead-onlyIdempotent
List ATF test suites in the instance
Inputs: limit, query, active.
list_atf_test_resultsARead-onlyIdempotent
List individual test results within a suite run
Inputs: limit, suite_result_sys_id.
list_atf_testsARead-onlyIdempotent
List ATF test cases, optionally filtered by suite
Inputs: limit, active, suite_sys_id.
list_attachmentsCRead-onlyIdempotent
List attachments associated with a specific record
Inputs: table (required), record_sys_id (required), limit.
list_audit_control_testsARead-onlyIdempotent
List Control Tests (sn_audit_control_test) — the record of testing a Control within an audit engagement; this is the real "audit result" (there is no sn_audit_result table). Filter by control, test plan, or design/operation effectiveness.
Inputs: limit, query, state, control, +4 more.
list_audit_engagementsARead-onlyIdempotent
List Audit Engagements (sn_audit_engagement) — the top-level audit project record. Filter by state or engagement type. Ordered by most recently updated.
Inputs: limit, query, state, display_value, +1 more.
list_business_rulesARead-onlyIdempotent
List business rules (requires SCRIPTING_ENABLED=true)
Inputs: limit, table, active.
list_catalog_itemsCRead-onlyIdempotent
List available service catalog items
Inputs: limit, category.
list_change_requestsARead-onlyIdempotent
List change requests with optional filtering by state or query
Inputs: limit, query, state.
list_changesetsARead-onlyIdempotent
List update sets (changesets) (requires SCRIPTING_ENABLED=true)
Inputs: limit, state.
list_cleanup_rulesBRead-onlyIdempotent
List Table Cleanup Rules (Auto Flush), optionally for one exact table.
Inputs: limit, table.
list_client_scriptsARead-onlyIdempotent
List client scripts (requires SCRIPTING_ENABLED=true)
Inputs: type, limit, table, active.
list_compliance_controlsARead-onlyIdempotent
List Compliance Controls (sn_compliance_control). Filter by state, category, or the Entity (profile) it protects.
Inputs: limit, query, state, profile, +3 more.
list_compliance_policiesARead-onlyIdempotent
List Compliance Policies (sn_compliance_policy). Filter by state or category.
Inputs: limit, query, state, category, +1 more.
list_control_objectivesARead-onlyIdempotent
List Control Objectives (sn_compliance_policy_statement) — sits between Policy and Control. No number field on this table; filter by state or category.
Inputs: limit, query, state, category, +1 more.
list_credential_aliasesARead-onlyIdempotent
List connection and credential aliases used by integrations
Inputs: type, limit, query.
list_csm_accountsBRead-onlyIdempotent
List customer accounts with optional search filter
Inputs: limit, query, active.
list_csm_casesARead-onlyIdempotent
List CSM cases with optional filters (account, contact, state, priority)
Inputs: limit, query, state, account, +2 more.
list_csm_contactsARead-onlyIdempotent
List contacts for an account or search across all contacts
Inputs: limit, query, account_sysid.
list_csm_productsARead-onlyIdempotent
List products and services available in the CSM catalog
Inputs: limit, query.
list_data_management_policiesBRead-onlyIdempotent
List Data Management Policies, optionally for one exact table.
Inputs: limit, table.
list_data_sourcesARead-onlyIdempotent
List Import Set data source definitions (file/JDBC/REST loaders)
Inputs: type, limit, query.
list_deployment_historyBRead-onlyIdempotent
List deployment history — committed update sets and app installs over time
Inputs: days, limit.
list_deploymentsBRead-onlyIdempotent
List recent application deployments tracked in ServiceNow
Inputs: limit, state, environment, pipeline_sys_id.
list_devops_pipelinesBRead-onlyIdempotent
List DevOps pipeline configurations registered in ServiceNow
Inputs: limit, active.
list_discovered_devicesARead-onlyIdempotent
List per-device Discovery results (discovery_device_history) — classification, resulting CI, and issue count. Use to answer "why was this server not discovered?"
Inputs: limit, run_id, source, with_issues_only.
list_discovery_credentialsARead-onlyIdempotent
List Discovery credential METADATA (name, type, order, MID scope) — secret fields are never returned
Inputs: type, limit, active.
list_discovery_logsARead-onlyIdempotent
List Discovery log entries (discovery_log) — sensor/probe messages with result codes, newest first
Inputs: limit, query, run_id, device_history_id.
list_discovery_rangesARead-onlyIdempotent
List Discovery IP ranges (discovery_range_item) — which IP ranges/networks are scanned
Inputs: limit, active.
list_discovery_runsARead-onlyIdempotent
List Discovery run history (discovery_status) — state, duration, and progress per scan, newest first
Inputs: limit, query, state.
list_discovery_schedulesARead-onlyIdempotent
List discovery schedules and their run status
Inputs: active_only.
list_ecc_queueARead-onlyIdempotent
Inspect the ECC Queue (ecc_queue) — the job/result bus between the instance and MID Servers. Useful for debugging Discovery, integrations, and ACC data flow. Payload is excluded by default (can be very large); set include_payload to fetch it. CAUTION: payloads can contain sensitive data (command output, host details, credential references) — request them only when needed and handle the output accordingly.
Inputs: agent, limit, queue, state, +4 more.
list_email_logsARead-onlyIdempotent
List outbound email log entries to track sent/failed emails
Inputs: limit, state, subject, recipient.
list_email_templatesCRead-onlyIdempotent
List email notification templates used by notifications
Inputs: limit, query.
list_epicsARead-onlyIdempotent
List epics with optional product, theme or state filter
Inputs: limit, state, theme, product.
list_event_logBRead-onlyIdempotent
List recent event log entries (fired events and their processing status)
Inputs: limit, state, event_name.
list_event_registryARead-onlyIdempotent
List registered event definitions in the ServiceNow event registry
Inputs: limit, query.
list_flow_executionsARead-onlyIdempotent
List recent executions of a flow with status (completed, error, running)
Inputs: flow_sys_id (required), limit, status.
list_flowsARead-onlyIdempotent
List Flow Designer flows with optional filter by name, category, or active status
Inputs: limit, query, active, category.
list_grc_entitiesARead-onlyIdempotent
List GRC Entities (sn_grc_profile) — the "thing being assessed" (business unit, vendor, application, process, etc.). No number/state field on this table; filter by class or CI.
Inputs: name, limit, query, cmdb_ci, +2 more.
list_grc_indicatorsARead-onlyIdempotent
List GRC Indicators (sn_grc_indicator, KRI/KPI) — periodic pass/fail metrics measuring a Control or Risk (item) for a given Entity. Filter by entity, category, or last result.
Inputs: item, limit, query, active, +4 more.
list_grc_issuesARead-onlyIdempotent
List GRC Issues (sn_grc_issue) — the generic finding/gap record used for compliance gaps and audit findings. Filter by state, Entity, or classification.
Inputs: limit, query, state, profile, +3 more.
list_groupsARead-onlyIdempotent
List groups with optional search filter
Inputs: limit, query.
list_homepagesARead-onlyIdempotent
List homepage dashboards (CMS content pages used as homepages)
Inputs: limit, query.
list_hr_casesARead-onlyIdempotent
List HR cases with optional filters (status, subject person, service)
Inputs: limit, query, state, hr_service, +1 more.
list_hr_document_templatesARead-onlyIdempotent
List available HR document templates (offer letters, contracts, policies)
Inputs: limit, active, category.
list_hr_servicesARead-onlyIdempotent
List available HR services (Onboarding, Offboarding, Benefits, Payroll, etc.)
Inputs: limit, query, active.
list_hr_tasksARead-onlyIdempotent
List HR tasks associated with an HR case
Inputs: hr_case_sysid (required), state.
list_import_setsBRead-onlyIdempotent
List Import Sets with optional filter by state or staging table
Inputs: limit, query, state.
list_indicator_resultsARead-onlyIdempotent
List Indicator Results (sn_grc_indicator_result) — individual pass/fail collection events for an Indicator. Empty on dev400464 at verification time (2026-07-12); included for instances where indicator collection has run.
Inputs: limit, query, passed, indicator, +1 more.
list_instancesARead-onlyIdempotent
List all configured ServiceNow instances (multi-instance / multi-customer support)
Inputs: no named parameters.
list_integration_implementationsARead-onlyIdempotent
List configured integration implementations/instances (sn_sec_int_impl) — the operational units that carry the active flag, default flag and validation status. Use this to see which feeds are actually enabled.
Inputs: limit, query, active, display_value.
list_integration_logsARead-onlyIdempotent
List integration log entries (sn_vul_integration_log) for troubleshooting — error and recommendation messages, optionally scoped to a single run. Ordered newest first.
Inputs: type, limit, query, category, +1 more.
list_integration_parametersARead-onlyIdempotent
List USEM/VR integration parameters. scope="definition" returns the parameter catalog (sn_sec_int_config: label, type, mandatory, default) optionally filtered by integration; scope="instance" returns the configured values per implementation (sn_sec_int_impl_config). Secret-like values (passwords, tokens, API keys) are masked and encrypted password_value columns are never returned.
Inputs: scope (required), limit, query, integration, +1 more.
list_integration_runsARead-onlyIdempotent
List Vulnerability Integration Runs (sn_vul_integration_run) with detail. Filter by source (e.g. "NVD"), state, substate ("success"/"failed"), or a recent day window. Ordered newest first. For a quick health rollup use get_integration_health instead.
Inputs: days, limit, query, state, +3 more.
list_integrationsARead-onlyIdempotent
List the USEM/VR integration catalog (sn_sec_int_integration) — the available security data feeds such as NVD, Qualys, Tenable, Red Hat. Returns name, id, source and type.
Inputs: limit, query.
list_job_run_historyARead-onlyIdempotent
Read scheduler history aggregates by job classification and time window (sys_scheduler_job_history), not individual job success/failure logs. job_sys_id and status filters are unsupported.
Inputs: limit, job_classification.
list_knowledge_basesBRead-onlyIdempotent
List all knowledge bases available in the instance
Inputs: limit.
list_license_positionsARead-onlyIdempotent
List SAM Pro effective license position (ELP) records — owned vs. used rights per product
Inputs: limit, product, publisher, over_licensed_only.
list_mid_extension_contextsARead-onlyIdempotent
List MID Server extension contexts (ecc_agent_ext_context) — e.g. MID Web Server, ACC Websocket Endpoint — with status and error_message. Key for troubleshooting ACC listener setup: a missing "ACC Websocket Endpoint" context means agents get handshake 404s.
Inputs: limit, status, extension, mid_server.
list_mid_server_issuesBRead-onlyIdempotent
List MID Server issues (ecc_agent_issue) — detected problems with source, occurrence count, and last-detected time
Inputs: limit, state, mid_server.
list_mid_serversARead-onlyIdempotent
List MID servers and verify they are healthy
Inputs: active_only.
list_mobile_app_configsBRead-onlyIdempotent
List sys_sg_mobile_application definitions, not installed client usage. This model has no active column.
Inputs: limit.
list_mobile_appletsBRead-onlyIdempotent
List native sys_sg_screen metadata. Historical applet name retained; scope is an application scope, not a mobile application ID.
Inputs: limit, scope.
list_mobile_layoutsCRead-onlyIdempotent
List sys_sg_screen_m2m_ui_element mappings, not complete mobile layout definitions. Historical tool name retained.
Inputs: limit, screen_sys_id.
list_my_tasksARead-onlyIdempotent
List tasks assigned to the currently configured user
Inputs: limit.
list_notificationsARead-onlyIdempotent
List email notification definitions (sysevent_email_action)
Inputs: event, limit, query, table, +1 more.
list_notification_subscriptionsARead-onlyIdempotent
List user subscriptions to notifications (who has opted in/out)
Inputs: limit, user_sys_id, notification_sys_id.
list_nvd_entriesARead-onlyIdempotent
List NVD entries (sn_vul_nvd_entry). Filter by CVE id substring or minimum CVSS v3 base score.
Inputs: cve, limit, query, score_min.
list_oauth_applicationsARead-onlyIdempotent
List OAuth application registry entries (client applications that can authenticate)
Inputs: limit, query.
list_pa_breakdownsARead-onlyIdempotent
List PA breakdowns (dimensions) available for segmenting indicator data
Inputs: limit, query.
list_pa_dashboardsBRead-onlyIdempotent
List Performance Analytics dashboards
Inputs: limit, query.
list_pa_indicatorsARead-onlyIdempotent
List Performance Analytics (PA) indicators (KPIs) available in the instance
Inputs: limit, query, active, category.
list_pa_jobsCRead-onlyIdempotent
List Performance Analytics data collection jobs and their schedules
Inputs: limit, query, active.
list_policy_exceptionsBRead-onlyIdempotent
List Policy Exceptions (sn_compliance_policy_exception). Filter by state.
Inputs: limit, query, state, policy, +1 more.
list_portal_pagesARead-onlyIdempotent
List pages that belong to a Service Portal
Inputs: portal_sys_id (required), limit, query.
list_portalsARead-onlyIdempotent
List all Service Portal configurations available in the instance
Inputs: limit, query.
list_portal_themesARead-onlyIdempotent
List Service Portal themes (color palettes, CSS variables)
Inputs: limit.
list_portal_widgetsARead-onlyIdempotent
List Service Portal widgets with optional search by name or category
Inputs: limit, query.
list_process_automationsCRead-onlyIdempotent
List Process Automation Designer playbooks and processes
Inputs: limit, query, active.
list_property_categoriesARead-onlyIdempotent
List all unique property categories with their record counts
Inputs: no named parameters.
list_relationshipsARead-onlyIdempotent
Show parent and child relationships for a CI
Inputs: ci_sys_id (required).
list_remediation_slaARead-onlyIdempotent
List the SLA (Time-To-Remediate) status of Vulnerable Items, Remediation Tasks, or Vulnerability Groups. Filter by ttr_status (no_target/in_flight/approaching/past_due/target_met), breaches only, an upcoming-due window, or assignment group. Ordered by soonest target date.
Inputs: record_type (required), limit, query, ttr_status, +4 more.
list_remediation_task_findingsARead-onlyIdempotent
List the VI ↔ Remediation Task links in the "Remediation Task Item" m2m (sn_vul_m2m_vul_group_item). Give remediation_task (VUL number or sys_id of the sn_vul_vulnerability group) to list its member Vulnerable Items, or vulnerable_item (VIT number or sys_id) to list the Remediation Tasks it belongs to. Exactly one of the two.
Inputs: limit, vulnerable_item, remediation_task.
list_remediation_tasksARead-onlyIdempotent
List USEM Remediation Tasks across BOTH backing tables: sn_vul_remediation_task and sn_vul_vulnerability (the task-based group the rule engine actually creates RTs in — sys_class label "Remediation Task", number prefix VUL). Each record carries a source_table marker. Filter by state or assignment group; ordered by descending risk score.
Inputs: limit, query, state, assigned_to, +2 more.
list_reportsARead-onlyIdempotent
List saved reports in the instance (latest release: /api/now/reporting)
Inputs: limit, search, category.
list_request_itemsBRead-onlyIdempotent
List requested items (sc_req_item) for a given request or catalog item
Inputs: limit, stage, request_sysid, cat_item_sysid.
list_requestsBRead-onlyIdempotent
List service catalog requests (sc_request). Supports filtering by state and requested_for user.
Inputs: limit, query, state, requested_for.
list_rest_message_functionsARead-onlyIdempotent
List HTTP methods (functions) defined within a REST Message
Inputs: rest_message_sys_id (required), limit.
list_rest_messagesARead-onlyIdempotent
List outbound REST Message configurations (integrations with external APIs)
Inputs: limit, query.
list_risk_criteriaARead-onlyIdempotent
List the Impact/Likelihood/Score scale (sn_risk_criteria) used by Risk records — 5 rows per type, ordered. Reference only: impact/likelihood/score are NOT settable via create_risk/update_risk (confirmed to be recalculated by a business rule regardless of client input) — use this tool to understand the scale a Risk's calculated values fall on, not to prepare a write.
Inputs: type.
list_risksARead-onlyIdempotent
List Risks (sn_risk_risk) — the quantitative risk register entry. Filter by state, related Entity, or category. Ordered by most recently updated.
Inputs: limit, query, state, profile, +2 more.
list_risk_statementsBRead-onlyIdempotent
List the Risk Statement library (sn_risk_definition) — reusable risk descriptions referenced by Risk records.
Inputs: name, limit.
list_scheduled_jobsARead-onlyIdempotent
List scheduled jobs and their run schedules
Inputs: limit, query, active.
list_scoped_appsARead-onlyIdempotent
List scoped applications (custom apps) installed in the instance
Inputs: limit, query, active.
list_script_includesARead-onlyIdempotent
List script includes (requires SCRIPTING_ENABLED=true)
Inputs: limit, query, active.
list_scrum_tasksARead-onlyIdempotent
List scrum tasks, optionally filtered by story
Inputs: limit, assigned_to, story_sys_id.
list_security_incidentsBRead-onlyIdempotent
List security incidents with filters (severity, state, category)
Inputs: limit, query, state, category, +1 more.
list_security_playbooksARead-onlyIdempotent
List Security Incident Response playbooks. These are Process Automation Designer definitions (sys_pd_process_definition) shipped in the sn_si_aw scope, e.g. the Malware / Phishing / Failed Login templates.
Inputs: limit, query, active.
list_soap_message_functionsARead-onlyIdempotent
List SOAP Message Functions (operations) for a given SOAP Message
Inputs: soap_message_sys_id (required), limit.
list_soap_messagesARead-onlyIdempotent
List outbound SOAP Message configurations (sys_soap_message). Endpoints live on each function, not the message.
Inputs: limit, query.
list_software_discovery_modelsCRead-onlyIdempotent
List normalized software discovery models (raw discovery output before/after normalization)
Inputs: limit, approved, publisher.
list_software_installsBRead-onlyIdempotent
List discovered software installations with publisher, version, and license status
Inputs: limit, query, product, publisher, +1 more.
list_software_licensesARead-onlyIdempotent
List software license records with compliance status
Inputs: limit, query.
list_software_lifecycle_entriesBRead-onlyIdempotent
List software lifecycle master data — publisher-provided phase entries (GA/EOL/EOS/EOES) per product/version, with risk rating
Inputs: risk, limit, active, product, +2 more.
list_software_lifecycle_reportsBRead-onlyIdempotent
List software lifecycle reports — current/upcoming EOL/EOS phase, install count, and CVE exposure per product
Inputs: limit, product, publisher, current_phase.
list_software_modelsBRead-onlyIdempotent
List software models — specific version/edition entitlement units of a product (license type, EOL date, install count)
Inputs: limit, query, product, publisher.
list_software_productsCRead-onlyIdempotent
List the normalized software product catalog (publisher, product type)
Inputs: name, limit, publisher.
list_storiesBRead-onlyIdempotent
List agile stories with optional sprint or state filter
Inputs: limit, state, sprint.
list_subflowsARead-onlyIdempotent
List available subflows that can be reused across flows
Inputs: limit, query, active.
list_system_propertiesCRead-onlyIdempotent
List system properties with optional filtering
Inputs: type, limit, query, category.
list_transform_field_mapsARead-onlyIdempotent
List field-level mappings within a Transform Map
Inputs: transform_map_sys_id (required), limit.
list_transform_mapsBRead-onlyIdempotent
List Transform Maps used for importing data into ServiceNow tables
Inputs: limit, query, target_table.
list_ui_actionsARead-onlyIdempotent
List UI Actions (buttons, context menus, related links) for a table (requires SCRIPTING_ENABLED=true)
Inputs: type, limit, table, active.
list_uib_componentsBRead-onlyIdempotent
List available UI Builder components (macroponents) in the instance
Inputs: limit, scope.
list_uib_data_brokersARead-onlyIdempotent
List UI Builder data brokers (data sources for pages)
Inputs: limit, page_sys_id.
list_uib_pagesARead-onlyIdempotent
List UI Builder pages and their route configurations
Inputs: app, limit.
list_ui_policiesARead-onlyIdempotent
List UI Policies for a table (field visibility, mandatory, read-only rules) (requires SCRIPTING_ENABLED=true)
Inputs: limit, table, active.
list_update_setsBRead-onlyIdempotent
List Update Sets by state (in progress, complete, ignore)
Inputs: limit, query, state.
list_usem_rulesARead-onlyIdempotent
List USEM/Vulnerability Response automation rules and configs of a given type (assignment, remediation_task, remediation_target, risk_calculator, calculator_rule, risk_field, risk_score_weight, calculator_config, classification, classification_rule, exception_rule, exception_config, rollup, approval, auto_close, exclusion). Ordered by execution order where the table has one, otherwise by a natural key. Optionally filter by active state or an extra encoded query.
Inputs: rule_type (required), limit, query, active, +1 more.
list_usersBRead-onlyIdempotent
List users with optional search filter
Inputs: limit, query.
list_ux_appsARead-onlyIdempotent
List Next Experience (UI Builder) applications
Inputs: limit, query.
list_ux_pagesBRead-onlyIdempotent
List pages within a Next Experience (UI Builder) application
Inputs: app_sys_id (required), limit, query.
list_va_categoriesARead-onlyIdempotent
List Virtual Agent topic categories
Inputs: limit.
list_va_conversationsARead-onlyIdempotent
List recent Virtual Agent conversations
Inputs: limit, user_sys_id, topic_sys_id.
list_va_topics_fullBRead-onlyIdempotent
List all Virtual Agent topics with category and status details
Inputs: limit, query, active, category.
list_vr_approvalsARead-onlyIdempotent
List approval records (sysapproval_approver) for Vulnerability Response items — exception, risk-acceptance and false-positive requests whose approval drives a VR state transition. Defaults to pending (state=requested). Each row shows the source record class and number.
Inputs: limit, state, source_table, approval_source.
list_vr_exception_requestsARead-onlyIdempotent
List Vulnerability Response exception requests (sn_sec_exception_change_approval) — False Positive, Risk Acceptance and Exception/Deferral requests raised against vulnerable items or groups. Shows request_type, the target record, the desired state/substate if approved, the approval_state, requester and reason. Approve/reject via act_on_vr_approval (find the approver rows with list_vr_approvals).
Inputs: limit, query, table, latest_only, +2 more.
list_vr_notificationsARead-onlyIdempotent
List Vulnerability Response notification definitions (sysevent_email_action) scoped to the VR table family (sn_vul_* / sn_sec_*). Use the generic create_notification/update_notification tools to modify them.
Inputs: limit, table, active, name_contains.
list_vulnerabilitiesARead-onlyIdempotent
List vulnerability entries from the Vulnerability Response module
Inputs: limit, query, state, ci_sysid, +1 more.
list_vulnerability_groupsARead-onlyIdempotent
List Vulnerability Groups (sn_vul_vulnerability) — the task-based remediation entity (sys_class label "Remediation Task", number prefix VUL). Filter by state, minimum risk score, or assignment group. Ordered by descending risk score. Use add_vi_to_remediation_task to add members and the SLA tools (record_type=vg) for TTR status.
Inputs: limit, query, state, display_value, +2 more.
list_vulnerable_itemsARead-onlyIdempotent
List USEM Vulnerable Items (sn_vul_vulnerable_item). Filter by state, minimum risk score, CMDB CI, or assignment group. Returns curated fields ordered by descending risk score.
Inputs: limit, query, state, cmdb_ci, +3 more.
list_widget_instancesBRead-onlyIdempotent
List instances of a specific widget placed on portal pages
Inputs: widget_sys_id (required), limit.
list_workspacesARead-onlyIdempotent
List legacy Agent Workspace definitions (sys_aw_master_config), not Configurable Workspace UX applications
Inputs: limit, active.
ml_detect_anomaliesBRead-onlyIdempotent
Run anomaly detection on operational metrics (alert volume, incident trends, etc.)
Inputs: field (required), table (required), days, threshold.
ml_evaluate_modelARead-onlyIdempotent
Get accuracy, training status, and metrics for a trained ML solution
Inputs: model_sys_id (required).
ml_forecast_incidentsARead-onlyIdempotent
Forecast incident volume for the next N days based on historical trends
Inputs: category, priority, days_ahead.
ml_model_training_historyARead-onlyIdempotent
Get training run history and accuracy trends for an ML solution over time
Inputs: model_sys_id (required), days.
ml_predict_change_riskARead-onlyIdempotent
Predict the risk level of a change request using historical ML analysis
Inputs: type, category, change_sys_id.
ml_process_optimizationBRead-onlyIdempotent
Identify process bottlenecks using analysis of task durations and reassignment patterns
Inputs: table (required), days.
ml_train_anomaly_detectorB
Trigger training of an anomaly detection model for a specific table/field. [Write]
Inputs: field (required), table (required).
ml_train_change_riskA
Trigger training of the change risk prediction ML model. [Write]
Inputs: solution_name.
ml_train_incident_classifierB
Trigger training of the incident classification ML solution. [Write]
Inputs: solution_name.
ml_virtual_agent_nluARead-onlyIdempotent
Analyse Virtual Agent NLU performance — conversation completion rates and fallback metrics
Inputs: days, topic_sys_id.
natural_language_searchBRead-onlyIdempotent
Search ServiceNow using plain English (experimental)
Inputs: query (required), limit.
natural_language_updateAIdempotent
Update a record using natural language (experimental, requires WRITE_ENABLED=true)
Inputs: table (required), instruction (required).
nlq_queryBRead-onlyIdempotent
Ask a natural language question and get structured ServiceNow data (ServiceNow NLQ API)
Inputs: question (required), limit, table.
order_catalog_itemA
Order a service catalog item (requires WRITE_ENABLED=true)
Inputs: sys_id (required), quantity, variables.
preview_update_setBRead-onlyIdempotent
Preview all changes contained in an Update Set
Inputs: sys_id (required), limit.
publish_changesetADestructive
Publish/export an update set to XML for deployment (requires SCRIPTING_ENABLED=true)
Inputs: sys_id (required).
publish_flowAIdempotent
Set active=true on a flow or subflow after verifying its type. This metadata update does not compile or perform the Flow Designer publish lifecycle. [Write]
Inputs: flow_sys_id (required), type.
publish_knowledge_articleAIdempotent
Publish a draft knowledge article (requires WRITE_ENABLED=true)
Inputs: sys_id (required).
query_recordsBRead-onlyIdempotent
Query ServiceNow records with filtering, field selection, pagination, and sorting
Inputs: table (required), limit, query, fields, +2 more.
register_eventA
Register a new custom event in the event registry (requires SCRIPTING_ENABLED=true)
Inputs: name (required), table (required), description.
reject_requestAIdempotent
Reject a pending approval request (requires WRITE_ENABLED=true)
Inputs: sys_id (required), comments (required).
remove_user_from_groupADestructive
Remove a user from a group (requires WRITE_ENABLED=true)
Inputs: member_sys_id (required).
resolve_incidentADestructive
Resolve an incident with resolution code and notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), resolution_code (required), resolution_notes (required).
resolve_problemADestructive
Resolve a problem with root cause and resolution notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), root_cause (required), resolution_notes (required).
restore_archived_recordBDestructive
Schedule a one-time standard ServiceNow restore for one archive log entry. The archive row is removed after successful restore. [Destructive]
Inputs: confirmation (required), archive_log_sys_id (required).
retire_assetADestructive
Retire an IT asset (mark as disposed/retired). [Write]
Inputs: sys_id (required), disposal_date, disposal_reason.
retire_knowledge_articleADestructive
[Write] Retire a knowledge article (mark as outdated)
Inputs: article_id (required).
review_update_set_best_practicesARead-onlyIdempotent
Read-only PoC review of Update Set payloads by sys_id, Australia only. Defaults: AU-BR-001/002 and AU-CL-004. Explicit BR opt-ins: AU-QRY-001 (literal addQuery LIKE, not encoded queries), AU-BR-004 (script variable declarations), AU-BR-005 (before BR post-abort processing), AU-BR-007 (stored before_display current writes). Explicit Client Script opt-in AU-CL-006: bounded g_form setMandatory/setVisible/setDisplay/setReadOnly calls as UI Policy considerations. Complex logic and UI constraints are not blanket violations or automatic exemptions; suitability/order/UI compatibility need review. Never auto-migrate or add return/update. Source-free low-confidence candidates with official sources, not certification. Unresolved evidence prevents analysis_complete. selection_mode=review_targets returns 0.3; omitted/bounded_all keeps 0.2. ACL-before-limit/coarse prefixes can hide targets. Zero findings never establish safety. Limits: 100 metadata rows plus lookahead, 60 seconds. No code execution/external LLM lookup.
Inputs: update_set_sys_id (required), instance, max_records, selection_mode, +1 more.
rollback_deploymentADestructive
Rollback a deployment by reverting an update set. [Write]
Inputs: update_set_sys_id (required), reason.
run_aggregate_queryBRead-onlyIdempotent
Run a grouped aggregate (COUNT, SUM, AVG) query on any table (latest release: /api/now/stats/{table})
Inputs: table (required), group_by (required), limit, query, +1 more.
run_atf_suiteA
Execute an ATF test suite (requires ATF_ENABLED=true)
Inputs: sys_id (required).
run_atf_testA
Execute a single ATF test (requires ATF_ENABLED=true)
Inputs: sys_id (required).
run_discovery_scanB
[CMDB Write] Trigger a ServiceNow Discovery scan for network/infrastructure
Inputs: schedule_id (required), mid_server.
run_security_playbookA
Start a Security Incident Response playbook (a Process Automation Designer definition in the sn_si_aw scope) against a security incident, the same way the SIR Analyst Workspace does: sn_playbook.PlaybookExperience.triggerPlaybook(). Schedules a one-time server script, so it requires SCRIPTING_ENABLED=true. Skips if that playbook is already queued or in progress on the incident. Set wait_seconds to poll for the resulting execution (sys_pd_context). [Scripting]
Inputs: incident_sys_id (required), playbook, wait_seconds, playbook_sys_id.
run_transform_mapA
Request a Transform Map run on an Import Set by creating a sys_import_set_run record; whether this starts the transform is not verified (requires WRITE_ENABLED=true; also SCRIPTING_ENABLED=true when the map runs scripts or targets a protected platform table such as sys_*/sp_*)
Inputs: import_set_sys_id (required), transform_map_sys_id (required).
scan_update_set_scaB
Read-only SCA scan for an Update Set. Inventories script-bearing changes and returns normalized, exact-version component metadata with hashed evidence only; source code is never returned.
Inputs: update_set (required), max_records, lookup_vulnerabilities.
scan_vulnerabilitiesA
Create a Vulnerability Response scan (sn_vul_scan) for a set of CIs or Vulnerable Items and hand it to the active scanner integration, the same way the "Initiate Scan" / "Rescan" actions do. Needs an active scanner (sn_vul_scanner, e.g. Qualys/Tenable/Rapid7) unless initiate=false, which leaves a Draft scan to launch from the UI. Runs as a server script in a run-once job (SCRIPTING_ENABLED) because the scan state and target links are not writable through the Table API. [Write]
Inputs: initiate, ci_sys_ids, wait_seconds, scanner_sys_id, +1 more.
schedule_cab_meetingC
[Write] Schedule a Change Advisory Board (CAB) meeting
Inputs: date (required), change_id (required), attendees, duration_minutes.
schedule_notificationC
[Write] Schedule a notification for future delivery
Inputs: schedule (required), notification_id (required), active.
search_catalogARead-onlyIdempotent
Search the service catalog for items matching a keyword
Inputs: query (required), limit.
search_cmdb_ciBRead-onlyIdempotent
Search for configuration items (CIs) in the CMDB
Inputs: limit, query.
search_knowledgeARead-onlyIdempotent
Search knowledge base articles by keyword
Inputs: query (required), limit, knowledge_base.
search_store_appsARead-onlyIdempotent
Search the public ServiceNow Store catalog by keyword (no instance auth needed). Returns listing_id values usable with get_store_app_versions.
Inputs: query (required), limit.
search_system_propertiesARead-onlyIdempotent
Search system properties by name, value, or description
Inputs: search (required), limit.
send_emergency_broadcastC
[Write] Send emergency broadcast notification to users or groups
Inputs: body (required), subject (required), recipients (required), channels.
send_push_notificationA
UNSUPPORTED: push delivery requires a validated notification workflow. No queue insert or delivery is performed. [Write]
Inputs: body (required), title (required), user, group, +1 more.
service_mapping_summaryARead-onlyIdempotent
View service dependencies and related CIs for impact analysis
Inputs: service_sys_id (required).
set_archive_rule_activeAIdempotent
Activate or deactivate an archive rule. Activation requires confirmation and an active Data Management Policy. [Write]
Inputs: active (required), sys_id (required), confirmation.
set_cleanup_rule_activeADestructive
Activate or deactivate a Table Cleanup Rule. Activation requires confirmation; matching live records are permanently deleted. [Destructive]
Inputs: active (required), sys_id (required), confirmation.
set_destroy_rule_activeADestructive
Activate or deactivate a destroy rule. Activation requires confirmation; it permanently deletes eligible archived records. [Destructive]
Inputs: active (required), sys_id (required), confirmation.
set_integration_activeAIdempotent
Enable or disable an integration implementation (sn_sec_int_impl) by sys_id. This turns a security data feed on or off. [Write — requires WRITE_ENABLED=true; admin-level change]
Inputs: active (required), sys_id (required).
set_remediation_commitmentAIdempotent
Set the remediation commitment / target date on a Vulnerable Item (remediation_commitment_dt_tm) or Remediation Task (ttr_target_date). [Write — requires WRITE_ENABLED=true]
Inputs: sys_id (required), record_type (required), commitment_date (required).
set_system_propertyBIdempotent
Create or update a ServiceNow system property value. [Write]
Inputs: name (required), value (required), type, description.
set_usem_rule_activeAIdempotent
Enable or disable a USEM/VR rule (convenience toggle of the active flag). Not supported for rule types without an active flag (exception_rule, exception_config, calculator_config, risk_field, risk_score_weight) — use update_usem_rule for those. [Write — requires WRITE_ENABLED=true; admin-level config change]
Inputs: active (required), sys_id (required), rule_type (required).
smart_queryARead-onlyIdempotent
Resolve a natural-language request into a ServiceNow table + encoded query and (optionally) run it. Maps keywords to common tables (incident, change_request, problem, sc_request, sn_vul_vulnerable_item, cmdb_ci, sys_user, …), then infers conditions for priority (P1/critical/high), open vs closed state, "assigned to me"/unassigned, and time windows (today, yesterday, this/last week, this/last month, last N days). Conditions whose field does not exist on the resolved table are dropped and reported in unmatched_intents. Returns the interpretation (table, encoded_query, conditions) plus matching records. Set execute=false to preview the query without running it, or pass table to override resolution.
Inputs: description (required), limit, table, execute.
submit_change_for_approvalAIdempotent
Move a change request to "Requested" state for approval (requires WRITE_ENABLED=true)
Inputs: sys_id (required).
suggest_resolutionARead-onlyIdempotent
Get AI-powered resolution suggestion for an incident based on similar past incidents
Inputs: incident_sys_id (required).
switch_instanceAIdempotent
Switch the active ServiceNow instance for this session
Inputs: name (required).
switch_update_setAIdempotent
Switch the active Update Set context to a specified Update Set. [Scripting]
Inputs: sys_id (required).
test_flowB
Execute a flow in test mode with sample inputs. [Write]
Inputs: flow_sys_id (required), test_inputs.
track_asset_lifecycleC
Track asset lifecycle events and stage transitions
Inputs: asset_id (required), new_stage (required), notes.
track_deploymentA
Record a deployment event in ServiceNow for audit and velocity tracking. [Write]
Inputs: status (required), environment (required), artifact_name (required), notes, +2 more.
trend_queryBRead-onlyIdempotent
Get time-bucketed trend data for a table (useful for monthly/weekly trend charts)
Inputs: table (required), group_by (required), date_field (required), query, +1 more.
trigger_agentic_playbookB
Invoke an Agentic Playbook — context-aware AI agents that complete tasks autonomously
Inputs: playbook_sys_id (required), context.
trigger_flowA
Trigger a Flow Designer flow with optional input parameters (requires WRITE_ENABLED=true)
Inputs: flow_sys_id (required), inputs.
trigger_scheduled_jobA
Immediately execute a scheduled job on-demand (requires WRITE_ENABLED=true)
Inputs: sys_id (required).
update_aclAIdempotent
Update an existing ACL rule (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_alertAIdempotent
Assign or annotate an alert. Allowed fields: assigned_to, assignment_group, work_notes, maintenance, short_description, description, kb. Use acknowledge_alert / close_alert for state changes. [Write]
Inputs: fields (required), number_or_sysid (required).
update_assetCIdempotent
Update an IT asset record. [Write]
Inputs: fields (required), sys_id (required).
update_business_ruleBIdempotent
Update a business rule (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_catalog_itemBIdempotent
Update an existing catalog item (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_change_requestBIdempotent
Update fields on a change request (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_client_scriptBIdempotent
Update an existing client script (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_compliance_controlAIdempotent
Update a Compliance Control by sys_id. NOTE: state is not in the allowed field set — confirmed live that REST writes to it are silently ignored (HTTP 200 but the value never persists); only the "Attest" button in the ServiceNow UI can actually move a Control into the attest state and trigger assessment generation. [Write — requires WRITE_ENABLED=true]
Inputs: fields (required), sys_id (required).
update_compliance_policyBIdempotent
Update a Compliance Policy by sys_id. [Write — requires WRITE_ENABLED=true]
Inputs: fields (required), sys_id (required).
update_csm_caseAIdempotent
Update fields on an existing CSM case (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_dashboardBIdempotent
Update an existing PA dashboard (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_epicAIdempotent
Update an epic (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_grc_entityBIdempotent
Update a GRC Entity by sys_id. [Write — requires WRITE_ENABLED=true]
Inputs: fields (required), sys_id (required).
update_grc_indicatorAIdempotent
Update a GRC Indicator by sys_id. entity/item are intentionally not updatable here — changing either risks the same entity/item validation failure confirmed on create; recreate the Indicator instead if it needs to measure a different Control/Risk or Entity. [Write — requires WRITE_ENABLED=true]
Inputs: fields (required), sys_id (required).
update_grc_issueBIdempotent
Update a GRC Issue by sys_id. [Write — requires WRITE_ENABLED=true]
Inputs: fields (required), sys_id (required).
update_groupAIdempotent
Update a group (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_hr_caseBIdempotent
Update fields on an existing HR case (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_hr_profileAIdempotent
Update HR profile fields for a user (requires WRITE_ENABLED=true)
Inputs: fields (required), user_sys_id (required).
update_incidentAIdempotent
Update fields on an existing incident (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_knowledge_articleBIdempotent
Update a knowledge article (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_notificationAIdempotent
Update an existing email notification (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_portal_widgetAIdempotent
Update an existing Service Portal widget's source code (requires WRITE_ENABLED=true and SCRIPTING_ENABLED=true, including metadata-only updates)
Inputs: fields (required), sys_id (required).
update_problemBIdempotent
Update fields on an existing problem (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_remediation_taskAIdempotent
Update a Remediation Task by sys_id (state, assignee, group, target date, etc.). [Write — requires WRITE_ENABLED=true]
Inputs: sys_id (required), state, assigned_to, ttr_target_date, +2 more.
update_reportBIdempotent
Update an existing saved report definition (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_request_itemAIdempotent
Update a requested item — stage, assignment, or work notes (requires WRITE_ENABLED=true)
Inputs: sys_id (required), stage, state, work_notes, +2 more.
update_riskAIdempotent
Update a Risk by sys_id. NOTE: impact/likelihood/score are not in the allowed field set — confirmed live that they are unconditionally recalculated by a business rule on write. [Write — requires WRITE_ENABLED=true]
Inputs: fields (required), sys_id (required).
update_scheduled_jobBIdempotent
Update a scheduled job (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_scoped_appBIdempotent
Update an existing scoped application (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_script_includeAIdempotent
Update a script include (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_scrum_taskBIdempotent
Update a scrum task (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_security_incidentBIdempotent
Update a security incident record (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_storyBIdempotent
Update an agile story (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_taskBIdempotent
Update fields on a task record (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_ui_actionBIdempotent
Update an existing UI Action (requires SCRIPTING_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_uib_componentCIdempotent
Update a UI Builder component. [Scripting]
Inputs: sys_id (required), label, description.
update_uib_pageCIdempotent
Update an existing UI Builder page. [Write]
Inputs: sys_id (required), path, title, layout.
update_usem_ruleAIdempotent
Update a USEM/VR automation rule by sys_id with a fields object restricted to that table allowlist. Every field is read back after the write; a value ServiceNow did not store fails with FIELDS_NOT_SAVED. Setting remediation_task assignment_group_fields runs a run-once server script and requires SCRIPTING_ENABLED=true. [Write — requires WRITE_ENABLED=true; admin-level config change]
Inputs: fields (required), sys_id (required), rule_type (required), wait_seconds.
update_userBIdempotent
Update a user account (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_va_topicCIdempotent
Update a Virtual Agent topic properties. [Write]
Inputs: fields (required), sys_id (required).
update_vulnerabilityAIdempotent
Update a vulnerability entry (state, risk acceptance notes, remediation date) (requires WRITE_ENABLED=true)
Inputs: fields (required), sys_id (required).
update_vulnerability_groupAIdempotent
Update a Vulnerability Group by sys_id — state transitions, (re)assignment, target date, etc. [Write — requires WRITE_ENABLED=true]
Inputs: sys_id (required), state, assigned_to, ttr_target_date, +2 more.
upload_attachmentA
Upload a base64-encoded attachment to a ServiceNow record (requires WRITE_ENABLED=true). Useful for adding files, screenshots, or documents to incidents, changes, etc.
Inputs: table (required), file_name (required), content_type (required), record_sys_id (required), +1 more.
validate_artifactBIdempotent
Validate an artifact for best practices, security issues, and performance concerns
Inputs: table (required), sys_id (required).
validate_deploymentAIdempotent
Pre-validate an update set or app before deployment — check for conflicts and missing dependencies
Inputs: app_sys_id, update_set_sys_id.
validate_propertyAIdempotent
Validate a property value against its declared type constraints without saving
Inputs: name (required), value (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 503 tools
The set contains many overlapping access patterns: query_records, smart_query, natural_language_search, nlq_query, ai_search, and search_knowledge all retrieve data through subtly different mechanisms. There are also multiple dashboard, property-management, update-set, and mobile tools whose boundaries require careful reading to distinguish. Individual descriptions are often detailed, but at 503 tools the risk of misselection across similar resources and actions is high.
Most tool names follow a readable snake_case verb_noun convention (e.g. create_incident, list_users, update_problem, get_hr_case). There are deviations such as query_records, describe_table, find_artifact, smart_query, and domain-prefixed ml_* tools, but they remain understandable rather than chaotic. The naming is mostly predictable despite the enormous surface.
503 tools is an extreme mismatch for a coherent MCP server surface and far beyond the recommended 3-15 tool range. Even with broad ServiceNow coverage, this volume makes discovery, selection, and maintenance impractical for an agent. The server appears to expose nearly every platform operation rather than a curated, well-scoped toolkit.
Coverage spans many ServiceNow domains—ITSM, HR, CSM, GRC, security, CMDB, reporting, integrations, platform metadata, and more—so many core workflows are represented. However, coverage is uneven: several tools are explicitly unsupported stubs, delete operations are sparse outside a few areas, and some modules have rich read surfaces but limited lifecycle coverage. It is extensive but not a complete, clean lifecycle surface for the stated broad purpose.
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables natural language interaction with ServiceNow instances for managing incidents, changes, CMDB, service catalog, users, groups, and knowledge base via MCP.4131 npm1MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for ServiceNow that provides over 60 pre-built tools for ITSM, ITOM, and App Dev operations, enabling AI agents to manage incidents, changes, users, service catalog, and projects through a unified interface.6MIT
- AlicenseAqualityBmaintenanceEnables AI agents to interact with ServiceNow through MCP, providing schema inspection, record CRUD, attachments, audit, Flow Designer, and platform investigations with policy-guarded access.154,188 PyPI4MIT
- AlicenseBqualityAmaintenanceConnect Claude AI to ServiceNow with 19 tools and 5 resources for incidents, CMDB, update sets, and more, accessible from any MCP client over stdio or Streamable HTTP.20303 PyPI27MIT