Skip to main content
Glama
         />_________________________________
[########[]_________________________________>
         \>

⛩️ servicenow-mcp ⛩️

⚔️ 武士道 (BUSHIDO) エディション ⚔️

AI-Powered Tools npm TypeScript License: MIT Node.js MCP

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 起動やレコード更新は実施していません

  • 詳細は CHANGELOG と E2E 検証記録 を参照

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 (無料開発インスタンス)

★★★ 推奨

無料。操作の影響なし。初めて使う方はここから

社内開発・検証インスタンス

★★☆ 可

チームと共有している場合は読み取り専用で開始

本番インスタンス

★☆☆ 要注意

WRITE_ENABLED=false + 専用サービスアカウント必須

無料 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 での起動

Docker 構成図

ソースビルド vs Docker — どちらを選ぶか

比較項目

ソースビルド(node dist/server.js)

Docker(docker run)

起動速度

✅ 即時

⚠️ コンテナ起動分のオーバーヘッドあり

設定のシンプルさ

⚠️ 絶対パスが必要

✅ 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-mcp

Password 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_secret

Password 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_password

OAuth セットアップ手順

OAuth は ServiceNow の管理者権限が必要です。PDI では自分で設定できます。

ServiceNow 側の設定

Step 1 — OAuth アプリケーションレジストリを作成

  1. ServiceNow にログイン

  2. 左メニューで「Application Registry」を検索

  3. 「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 test

AI クライアント別セットアップ

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=false

Cursor

設定ファイル: .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

デスクトップ

Setup

Claude Code CLI

ターミナル

Setup

Cursor

AI エディタ

Setup

Windsurf

AI エディタ

Setup

VS Code (Native MCP 1.99+)

IDE

Setup

VS Code + GitHub Copilot

IDE

Setup

VS Code + Continue.dev

IDE

Setup

VS Code + Cline

IDE

Setup

JetBrains AI

IDE

Setup

Amazon Q Developer

IDE / CLI

Setup

ChatGPT / OpenAI API

API

Setup

Google Gemini API

API

Setup

Ollama (ローカル LLM)

ローカル

Setup

全クライアントのセットアップ詳細 → 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_TRANSPORT

stdio

http で Streamable HTTP に切り替え

MCP_HTTP_PORT

3000

待ち受けポート

MCP_HTTP_HOST

127.0.0.1

バインドアドレス(外部公開時は 0.0.0.0)

MCP_HTTP_PATH

/mcp

MCP エンドポイントのパス

MCP_HTTP_AUTH_TOKEN

(必須)

MCP エンドポイント用 Bearer トークン。未設定時は /mcp への要求をすべて401で拒否

MCP_HTTP_CORS_ORIGIN

*

CORS 許可オリジン

MCP_HTTP_ALLOWED_HOSTS

(なし)

カンマ区切り。指定すると DNS リバインディング保護を有効化

MCP_HTTP_ALLOWED_ORIGINS

(なし)

カンマ区切り。Origin ヘッダの許可リスト

MCP_HTTP_MAX_BODY_BYTES

1048576

JSON-RPC 要求本文の最大バイト数

MCP_HTTP_MAX_SESSIONS

100

同時 HTTP MCP セッションの上限

MCP_HTTP_SESSION_IDLE_TIMEOUT_MS

1800000

未使用セッションを閉じるまでのミリ秒

セッションは 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/例外承認

パッケージ名

対象ロール

主なツール

full

管理者

全ツール (503)

service_desk

L1/L2 エージェント

インシデント・タスク・KB・SLA

change_coordinator

変更管理者

変更リクエスト・CAB・CMDB

knowledge_author

KB 著者

KB 作成・公開

catalog_builder

カタログ管理者

カタログ・承認ルール

system_administrator

システム管理者

ユーザー・グループ・レポート

platform_developer

開発者

スクリプト・ATF・Update Set

portal_developer

ポータル開発者

ポータル・ウィジェット・UX

integration_engineer

統合エンジニア

REST・Transform・イベント

itom_engineer

ITOM エンジニア

CMDB・Discovery(実行履歴/エラー調査)・MID ヘルス・ACC・Event Management アラート管理

agile_manager

スクラムマスター

ストーリー・エピック

ai_developer

AI 開発者

Now Assist・NLQ・Playbook

itam_analyst

資産管理者

資産・ライセンス・契約・SAM Pro(ソフトウェア資産管理)

secops_analyst

SecOps アナリスト

脆弱性(VI/RT)・RT横断検索・グルーピング診断・USEM・SLA・例外承認

devops_engineer

DevOps

パイプライン・デプロイ

詳細 → docs/TOOL_PACKAGES.md


使用例

自然言語で操作する

「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

詳細 → docs/MULTI_INSTANCE.md


モジュールカバレッジ

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.ts

Now 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 を定義しておき、「本番インスタンスに切り替えて」と指示するだけで切り替わります。


ドキュメント

ガイド

内容

docs/INSTALLATION.md

環境変数リファレンス

docs/CLIENT_SETUP.md

全 AI クライアントのセットアップ

docs/SERVICENOW_OAUTH_SETUP.md

ServiceNow OAuth アプリ作成手順(詳細版)

docs/TOOL_PACKAGES.md

ロールベースパッケージの詳細

docs/TOOLS.md

全ツールのパラメータ・権限要件

docs/MULTI_INSTANCE.md

マルチインスタンス設定

docs/NOW_ASSIST.md

Now Assist / AI 統合

docs/ATF.md

ATF テストガイド

EXAMPLES.md

120+ 実用例

SECURITY.md

セキュリティポリシー・脆弱性報告

CHANGELOG.md

変更履歴


コントリビュート

CONTRIBUTING.md をお読みの上、Pull Request をお送りください。
バグ報告・機能要望 → Issue を開く


セキュリティ

脆弱性を発見した場合は 公開 Issue には投稿せず、SECURITY.md の責任ある開示プロセスに従ってください。


ライセンス

MIT — 個人・商用利用とも無料。


503 ツール · 47 モジュール · ローカル PC で動作 · 永久オープンソース

役に立ったら ⭐ スターをお願いします — 他の人が見つけやすくなります。

GitHub Stars

Available Tools

503 tools
acknowledge_alertA
Idempotent

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

analyze_data_qualityA
Read-onlyIdempotent

Analyse data quality for a table — completeness, duplicates, stale records

Inputs: table (required), days_stale, required_fields.

approve_requestA
Idempotent

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_propertiesA
Idempotent

Create or update multiple system properties in a single operation. [Write]

Inputs: properties (required).

cancel_requestA
Destructive

Cancel an open service catalog request (requires WRITE_ENABLED=true)

Inputs: sys_id (required), comments.

categorize_incidentA
Read-onlyIdempotent

Use Predictive Intelligence to predict category, assignment group, and priority (latest release: LightGBM algorithm)

Inputs: short_description (required), description.

check_app_upgradeA
Read-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_accessA
Read-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_completenessB
Read-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_alertA
Destructive

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_requestA
Destructive

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_caseA
Destructive

Close a CSM case with resolution details (requires WRITE_ENABLED=true)

Inputs: sys_id (required), resolution_notes (required), resolution_code.

close_hr_caseA
Destructive

Close an HR case with resolution notes (requires WRITE_ENABLED=true)

Inputs: sys_id (required), close_notes (required), close_code.

close_incidentA
Destructive

Close a resolved incident (requires WRITE_ENABLED=true)

Inputs: sys_id (required).

cmdb_health_dashboardA
Read-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_changesetA
Destructive

Commit an update set (requires SCRIPTING_ENABLED=true)

Inputs: sys_id (required).

compare_record_countsB
Read-onlyIdempotent

Compare record counts across multiple ServiceNow tables or time periods — useful for capacity planning

Inputs: tables (required), query.

complete_taskA
Idempotent

Mark a task as complete (requires WRITE_ENABLED=true)

Inputs: sys_id (required), close_notes.

complete_update_setC
Idempotent

Mark an Update Set as complete (ready for migration). [Scripting]

Inputs: sys_id (required).

configure_offline_syncC
Idempotent

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_listA
Idempotent

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_attachmentA
Destructive

Delete an attachment from a record (requires WRITE_ENABLED=true)

Inputs: attachment_sys_id (required).

delete_system_propertyA
Destructive

Delete a system property by name. [Write]

Inputs: name (required).

delete_uib_pageB
Destructive

Delete a UI Builder page. [Write]

Inputs: sys_id (required).

describe_tableA
Read-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_setA
Idempotent

Ensure an active Update Set exists; create one automatically if none is in progress. [Scripting]

Inputs: default_name.

execute_background_scriptA
Destructive

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_propertiesA
Read-onlyIdempotent

Export system properties matching a query to a JSON object (useful for environment snapshots)

Inputs: query, category.

export_report_dataB
Read-onlyIdempotent

Export raw table data as structured JSON for use in external reports

Inputs: table (required), limit, query, fields.

export_update_setB
Read-onlyIdempotent

Get the XML export payload for an Update Set (as used in migration). [Scripting]

Inputs: sys_id (required).

find_artifactA
Read-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_summaryB
Read-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_aclA
Read-onlyIdempotent

Get full details of an ACL rule including its script and role requirements (requires SCRIPTING_ENABLED=true)

Inputs: sys_id (required).

get_alertA
Read-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_summaryA
Read-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_statusB
Read-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_assetA
Read-onlyIdempotent

Get full details of an IT asset including financial and lifecycle data

Inputs: sys_id (required).

get_atf_failure_insightA
Read-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_suiteA
Read-onlyIdempotent

Get details of a test suite including test count

Inputs: sys_id_or_name (required).

get_atf_suite_resultB
Read-onlyIdempotent

Get the results of a test suite run

Inputs: result_sys_id (required).

get_atf_testA
Read-onlyIdempotent

Get details of a specific test case

Inputs: sys_id (required).

get_attachment_metadataA
Read-onlyIdempotent

Get metadata (name, type, size) of a specific attachment by its sys_id

Inputs: attachment_sys_id (required).

get_audit_control_testA
Read-onlyIdempotent

Get full details of a single Control Test by sys_id or number (e.g. "CTR0000153").

Inputs: number_or_sysid (required).

get_audit_engagementA
Read-onlyIdempotent

Get full details of a single Audit Engagement by sys_id or number (e.g. "ENG0000104").

Inputs: number_or_sysid (required).

get_business_ruleA
Read-onlyIdempotent

Get full details and script body of a business rule (requires SCRIPTING_ENABLED=true)

Inputs: sys_id (required).

get_catalog_itemA
Read-onlyIdempotent

Get full details of a catalog item including its variables

Inputs: sys_id_or_name (required).

get_change_requestA
Read-onlyIdempotent

Get full details of a change request by number (CHG...) or sys_id

Inputs: number_or_sysid (required).

get_changesetA
Read-onlyIdempotent

Get details of an update set (requires SCRIPTING_ENABLED=true)

Inputs: sys_id_or_name (required).

get_client_scriptA
Read-onlyIdempotent

Get full details and script body of a client script (requires SCRIPTING_ENABLED=true)

Inputs: sys_id (required).

get_cmdb_ciB
Read-onlyIdempotent

Get complete information about a specific configuration item

Inputs: ci_sys_id (required), fields.

get_compliance_controlA
Read-onlyIdempotent

Get full details of a single Compliance Control by sys_id or number (e.g. "CTRL0020012").

Inputs: number_or_sysid (required).

get_compliance_policyA
Read-onlyIdempotent

Get full details of a single Compliance Policy by sys_id or number (e.g. "POL0010200").

Inputs: number_or_sysid (required).

get_control_objectiveB
Read-onlyIdempotent

Get full details of a single Control Objective by sys_id.

Inputs: sys_id (required).

get_csm_accountA
Read-onlyIdempotent

Get details of a customer account including contacts and open cases count

Inputs: name_or_sysid (required).

get_csm_caseA
Read-onlyIdempotent

Get full details of a CSM case by number (e.g. CS0001234) or sys_id

Inputs: number_or_sysid (required).

get_csm_case_slaA
Read-onlyIdempotent

Get SLA details and remaining time for a CSM case

Inputs: case_sysid (required).

get_csm_contactA
Read-onlyIdempotent

Get details of a customer contact (name, account, phone, email)

Inputs: name_or_sysid (required).

get_current_instanceA
Read-onlyIdempotent

Get the currently active ServiceNow instance name and URL

Inputs: no named parameters.

get_current_update_setA
Read-onlyIdempotent

Get the currently active Update Set for the session

Inputs: no named parameters.

get_data_management_policyC
Read-onlyIdempotent

Get a Data Management Policy and the archive rules for its table.

Inputs: sys_id (required).

get_deploymentA
Read-onlyIdempotent

Get details and status of a specific deployment

Inputs: sys_id (required).

get_devops_insightsA
Read-onlyIdempotent

Get deployment frequency, failure rate, and lead time metrics for a pipeline

Inputs: days, pipeline_sys_id.

get_devops_pipelineA
Read-onlyIdempotent

Get details of a specific DevOps pipeline

Inputs: sys_id (required).

get_discovery_runB
Read-onlyIdempotent

Get one Discovery run by sys_id or number (DIS...), including full status fields

Inputs: run_id (required).

get_email_logA
Read-onlyIdempotent

Get full details of an email log entry including body and headers

Inputs: sys_id (required).

get_event_registry_entryA
Read-onlyIdempotent

Get details of a specific registered event definition

Inputs: name_or_sysid (required).

get_finding_grouping_statusA
Read-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_flowA
Read-onlyIdempotent

Get full details of a Flow Designer flow including its actions and trigger

Inputs: name_or_sysid (required).

get_flow_error_logA
Read-onlyIdempotent

Get detailed error logs for failed flow executions

Inputs: flow_sys_id (required), days, limit.

get_flow_executionA
Read-onlyIdempotent

Get the status and details of a specific flow execution

Inputs: execution_sysid (required).

get_grc_audit_dashboardA
Read-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_dashboardA
Read-onlyIdempotent

Summarize the Compliance posture: Policy/Control/Issue counts by state, and the highest-risk open Policy Exceptions.

Inputs: top.

get_grc_entityA
Read-onlyIdempotent

Get full details of a single GRC Entity by sys_id.

Inputs: sys_id (required).

get_grc_indicatorA
Read-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_dashboardA
Read-onlyIdempotent

Summarize Indicator posture: counts by category and by last-result pass/fail.

Inputs: no named parameters.

get_grc_issueA
Read-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_dashboardA
Read-onlyIdempotent

Summarize the Risk posture: Risk counts by state, and the highest-scored open risks.

Inputs: top.

get_groupA
Read-onlyIdempotent

Find assignment group details by name or sys_id

Inputs: group_identifier (required).

get_group_slaA
Read-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_caseA
Read-onlyIdempotent

Get full details of an HR case by number (e.g. HRCS0001234) or sys_id

Inputs: number_or_sysid (required).

get_hr_case_activityA
Read-onlyIdempotent

Get the full activity log and journal entries for an HR case

Inputs: hr_case_sysid (required).

get_hr_lifecycle_eventsA
Read-onlyIdempotent

Get HR lifecycle events for an employee (promotions, transfers, leaves)

Inputs: employee_sys_id (required), limit, event_type.

get_hr_profileA
Read-onlyIdempotent

Get the HR profile for a user (employment details, department, manager)

Inputs: user_identifier (required).

get_hr_serviceA
Read-onlyIdempotent

Get details of a specific HR service including its tasks and SLAs

Inputs: sys_id_or_name (required).

get_import_setA
Read-onlyIdempotent

Get details of a specific Import Set including row count and transform status

Inputs: sys_id (required).

get_incidentA
Read-onlyIdempotent

Get full details of an incident by number (e.g. INC0012345) or sys_id

Inputs: number_or_sysid (required).

get_indicator_resultA
Read-onlyIdempotent

Get full details of a single Indicator Result by sys_id.

Inputs: sys_id (required).

get_instance_diagnosticsA
Read-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_healthA
Read-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_runA
Read-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_articleA
Read-onlyIdempotent

Get the full content of a knowledge article by number (KB...) or sys_id

Inputs: number_or_sysid (required).

get_license_complianceA
Read-onlyIdempotent

Get license compliance summary — purchased vs. installed vs. in use counts

Inputs: license_sys_id.

get_license_optimizationB
Read-onlyIdempotent

Analyze software license usage and recommend optimizations

Inputs: software_name, threshold_pct.

get_license_position_summaryA
Read-onlyIdempotent

Aggregate license-compliance dashboard: over-licensed vs. under-licensed counts, total potential savings, total true-up cost

Inputs: publisher.

get_mid_server_healthA
Read-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_analyticsA
Read-onlyIdempotent

UNSUPPORTED: no validated mobile session telemetry source is configured. Returns an error rather than invented usage counts.

Inputs: days.

get_mobile_app_configA
Read-onlyIdempotent

Get details of a specific mobile app configuration

Inputs: sys_id (required).

get_ms_copilot_topicsA
Read-onlyIdempotent

List VA topics exposed to Microsoft Copilot 365 via Custom Engine Agent integration

Inputs: limit.

get_my_approvalsA
Read-onlyIdempotent

List approvals pending for the currently configured user

Inputs: state.

get_notificationA
Read-onlyIdempotent

Get full details of an email notification definition including template and conditions

Inputs: sys_id_or_name (required).

get_nvd_entry_by_cveA
Read-onlyIdempotent

Look up a single NVD entry by exact CVE id (e.g. "CVE-2018-1002203").

Inputs: cve (required).

get_pa_dashboardA
Read-onlyIdempotent

Get details of a PA dashboard including its widgets/tabs

Inputs: sys_id_or_name (required).

get_pa_indicatorA
Read-onlyIdempotent

Get details of a specific Performance Analytics indicator including its formula

Inputs: sys_id_or_name (required).

get_pa_jobB
Read-onlyIdempotent

Get details of a Performance Analytics collection job

Inputs: sys_id (required).

get_pa_scorecardA
Read-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_seriesB
Read-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_analyticsB
Read-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_historyA
Read-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_modelsA
Read-onlyIdempotent

List available Predictive Intelligence solutions (classification/similarity models)

Inputs: no named parameters.

get_policy_exceptionB
Read-onlyIdempotent

Get full details of a single Policy Exception by sys_id or number (e.g. "PER0000106").

Inputs: number_or_sysid (required).

get_portalA
Read-onlyIdempotent

Get full configuration details of a Service Portal by sys_id or URL suffix

Inputs: id (required).

get_portal_pageB
Read-onlyIdempotent

Get details of a specific Service Portal page including its layout

Inputs: sys_id (required).

get_portal_themeA
Read-onlyIdempotent

Get full details of a Service Portal theme including CSS variables

Inputs: sys_id (required).

get_portal_widgetA
Read-onlyIdempotent

Get full source code (HTML, CSS, client/server scripts) of a Service Portal widget

Inputs: id_or_sysid (required).

get_problemA
Read-onlyIdempotent

Get full details of a problem by number (PRB...) or sys_id

Inputs: number_or_sysid (required).

get_process_automationC
Read-onlyIdempotent

Get details of a Process Automation Designer playbook or process

Inputs: name_or_sysid (required).

get_property_historyA
Read-onlyIdempotent

Get audit history of changes to a system property

Inputs: name (required), limit.

get_recordA
Read-onlyIdempotent

Retrieve complete details of a specific record by sys_id

Inputs: table (required), sys_id (required), fields.

get_remediation_slaA
Read-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_taskA
Read-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_reportA
Read-onlyIdempotent

Get the definition and metadata of a saved report

Inputs: sys_id_or_name (required).

get_requestA
Read-onlyIdempotent

Get a service catalog request (sc_request) by number or sys_id, including its requested items

Inputs: number_or_sysid (required).

get_request_itemA
Read-onlyIdempotent

Get a requested item (sc_req_item) by number or sys_id, including its fulfillment tasks

Inputs: number_or_sysid (required).

get_rest_messageA
Read-onlyIdempotent

Get full configuration of an outbound REST Message including its endpoints

Inputs: sys_id_or_name (required).

get_riskA
Read-onlyIdempotent

Get full details of a single Risk by sys_id or number (e.g. "RK0020310").

Inputs: number_or_sysid (required).

get_risk_calculator_detailsA
Read-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_statementA
Read-onlyIdempotent

Get full details of a single Risk Statement by sys_id.

Inputs: sys_id (required).

get_scheduled_jobA
Read-onlyIdempotent

Get full details of a scheduled job by sys_id or name

Inputs: sys_id_or_name (required).

get_scoped_appA
Read-onlyIdempotent

Get full details of a scoped application by sys_id or scope name

Inputs: id (required).

get_script_includeA
Read-onlyIdempotent

Get full script body of a script include (requires SCRIPTING_ENABLED=true)

Inputs: sys_id_or_name (required).

get_security_dashboardA
Read-onlyIdempotent

Get security posture dashboard — open incidents by severity, vulnerability counts, mean time to resolve

Inputs: days.

get_security_incidentA
Read-onlyIdempotent

Get full details of a security incident by number or sys_id

Inputs: number_or_sysid (required).

get_sla_detailsA
Read-onlyIdempotent

Get SLA breach status for a specific task or incident

Inputs: task_sys_id (required).

get_soap_messageA
Read-onlyIdempotent

Get full configuration of a SOAP Message including its functions/operations

Inputs: sys_id_or_name (required).

get_software_installB
Read-onlyIdempotent

Get full details of a discovered software installation

Inputs: sys_id (required).

get_software_lifecycle_reportA
Read-onlyIdempotent

Get full lifecycle report details for one product (all phase dates, CVE breakdown, owners)

Inputs: sys_id (required).

get_software_modelA
Read-onlyIdempotent

Get full details of a software model (rights, consumption rules, EOL date, lifecycle stage)

Inputs: sys_id (required).

get_store_app_versionsA
Read-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_subflowA
Read-onlyIdempotent

Get full details of a subflow including its inputs, outputs, and actions

Inputs: name_or_sysid (required).

get_sys_logA
Read-onlyIdempotent

Retrieve system log entries for debugging or auditing

Inputs: limit, query.

get_system_propertyA
Read-onlyIdempotent

Get a ServiceNow system property value and metadata by name

Inputs: name (required).

get_table_record_countA
Read-onlyIdempotent

Get total record count for a ServiceNow table with optional filters

Inputs: table (required), query.

get_table_schemaA
Read-onlyIdempotent

Get the structure and field information for a ServiceNow table

Inputs: table (required).

get_taskA
Read-onlyIdempotent

Get details of any task record by number or sys_id

Inputs: number_or_sysid (required).

get_threat_intelligenceA
Read-onlyIdempotent

Query threat intelligence data — IOCs, threat actors, and campaigns

Inputs: query (required), type, limit.

get_transform_mapA
Read-onlyIdempotent

Get details of a Transform Map including its field mappings

Inputs: sys_id_or_name (required).

get_ui_actionA
Read-onlyIdempotent

Get full details and script of a UI Action (requires SCRIPTING_ENABLED=true)

Inputs: sys_id (required).

get_uib_pageA
Read-onlyIdempotent

Get details of a specific UI Builder page including layout and child elements

Inputs: sys_id (required).

get_ui_policyA
Read-onlyIdempotent

Get full details and conditions of a UI Policy (requires SCRIPTING_ENABLED=true)

Inputs: sys_id (required).

get_usem_dashboardA
Read-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_ruleA
Read-onlyIdempotent

Get the full definition of a single USEM/VR rule by sys_id.

Inputs: sys_id (required), rule_type (required).

get_userB
Read-onlyIdempotent

Look up user details by email or username

Inputs: user_identifier (required).

get_ux_appA
Read-onlyIdempotent

Get configuration details of a Next Experience application

Inputs: sys_id_or_name (required).

get_va_conversationA
Read-onlyIdempotent

Get conversation history for a Virtual Agent session

Inputs: conversation_id (required), limit.

get_va_topicB
Read-onlyIdempotent

Get Virtual Agent topic details including intent and trigger phrases

Inputs: sys_id (required).

get_virtual_agent_topicsB
Read-onlyIdempotent

List Virtual Agent topics available in the instance (latest release: streaming VA API)

Inputs: limit, active, category.

get_vulnerabilityA
Read-onlyIdempotent

Get details of a specific vulnerability entry including CVSS score and affected CIs

Inputs: number_or_sysid (required).

get_vulnerability_groupB
Read-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_itemB
Read-onlyIdempotent

Get full details of a single Vulnerable Item by sys_id or VI number (e.g. "VIT0010003").

Inputs: number_or_sysid (required).

get_workspaceB
Read-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_agentsA
Read-onlyIdempotent

List ACC (Agent Client Collector) agents and their status. Requires the ACC plugin

Inputs: limit, query, status.

list_acc_checksB
Read-onlyIdempotent

List ACC check definitions. Requires the ACC plugin

Inputs: limit, query.

list_acc_policiesA
Read-onlyIdempotent

List ACC monitoring/check policies. Requires the ACC plugin

Inputs: limit, active.

list_aclsA
Read-onlyIdempotent

List Access Control rules (ACLs) — who can read/write/create/delete records (requires SCRIPTING_ENABLED=true)

Inputs: limit, table, active, operation.

list_action_instancesB
Read-onlyIdempotent

List reusable Flow Designer action instances available in the environment

Inputs: limit, query, category.

list_active_eventsA
Read-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_slasA
Read-onlyIdempotent

List active SLA records with optional filters

Inputs: limit, query.

list_alertsA
Read-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_approvalsA
Read-onlyIdempotent

List approval requests with optional filters

Inputs: limit, query, state.

list_archive_rulesB
Read-onlyIdempotent

List archive rules, optionally for one exact table.

Inputs: limit, table.

list_asset_contractsB
Read-onlyIdempotent

List asset maintenance and support contracts

Inputs: limit, active, asset_sys_id.

list_assetsB
Read-onlyIdempotent

List IT assets with optional filtering by state, class, or assigned user

Inputs: limit, query, state, location, +2 more.

list_atf_suitesA
Read-onlyIdempotent

List ATF test suites in the instance

Inputs: limit, query, active.

list_atf_test_resultsA
Read-onlyIdempotent

List individual test results within a suite run

Inputs: limit, suite_result_sys_id.

list_atf_testsA
Read-onlyIdempotent

List ATF test cases, optionally filtered by suite

Inputs: limit, active, suite_sys_id.

list_attachmentsC
Read-onlyIdempotent

List attachments associated with a specific record

Inputs: table (required), record_sys_id (required), limit.

list_audit_control_testsA
Read-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_engagementsA
Read-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_rulesA
Read-onlyIdempotent

List business rules (requires SCRIPTING_ENABLED=true)

Inputs: limit, table, active.

list_catalog_itemsC
Read-onlyIdempotent

List available service catalog items

Inputs: limit, category.

list_change_requestsA
Read-onlyIdempotent

List change requests with optional filtering by state or query

Inputs: limit, query, state.

list_changesetsA
Read-onlyIdempotent

List update sets (changesets) (requires SCRIPTING_ENABLED=true)

Inputs: limit, state.

list_cleanup_rulesB
Read-onlyIdempotent

List Table Cleanup Rules (Auto Flush), optionally for one exact table.

Inputs: limit, table.

list_client_scriptsA
Read-onlyIdempotent

List client scripts (requires SCRIPTING_ENABLED=true)

Inputs: type, limit, table, active.

list_compliance_controlsA
Read-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_policiesA
Read-onlyIdempotent

List Compliance Policies (sn_compliance_policy). Filter by state or category.

Inputs: limit, query, state, category, +1 more.

list_control_objectivesA
Read-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_aliasesA
Read-onlyIdempotent

List connection and credential aliases used by integrations

Inputs: type, limit, query.

list_csm_accountsB
Read-onlyIdempotent

List customer accounts with optional search filter

Inputs: limit, query, active.

list_csm_casesA
Read-onlyIdempotent

List CSM cases with optional filters (account, contact, state, priority)

Inputs: limit, query, state, account, +2 more.

list_csm_contactsA
Read-onlyIdempotent

List contacts for an account or search across all contacts

Inputs: limit, query, account_sysid.

list_csm_productsA
Read-onlyIdempotent

List products and services available in the CSM catalog

Inputs: limit, query.

list_data_management_policiesB
Read-onlyIdempotent

List Data Management Policies, optionally for one exact table.

Inputs: limit, table.

list_data_sourcesA
Read-onlyIdempotent

List Import Set data source definitions (file/JDBC/REST loaders)

Inputs: type, limit, query.

list_deployment_historyB
Read-onlyIdempotent

List deployment history — committed update sets and app installs over time

Inputs: days, limit.

list_deploymentsB
Read-onlyIdempotent

List recent application deployments tracked in ServiceNow

Inputs: limit, state, environment, pipeline_sys_id.

list_devops_pipelinesB
Read-onlyIdempotent

List DevOps pipeline configurations registered in ServiceNow

Inputs: limit, active.

list_discovered_devicesA
Read-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_credentialsA
Read-onlyIdempotent

List Discovery credential METADATA (name, type, order, MID scope) — secret fields are never returned

Inputs: type, limit, active.

list_discovery_logsA
Read-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_rangesA
Read-onlyIdempotent

List Discovery IP ranges (discovery_range_item) — which IP ranges/networks are scanned

Inputs: limit, active.

list_discovery_runsA
Read-onlyIdempotent

List Discovery run history (discovery_status) — state, duration, and progress per scan, newest first

Inputs: limit, query, state.

list_discovery_schedulesA
Read-onlyIdempotent

List discovery schedules and their run status

Inputs: active_only.

list_ecc_queueA
Read-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_logsA
Read-onlyIdempotent

List outbound email log entries to track sent/failed emails

Inputs: limit, state, subject, recipient.

list_email_templatesC
Read-onlyIdempotent

List email notification templates used by notifications

Inputs: limit, query.

list_epicsA
Read-onlyIdempotent

List epics with optional product, theme or state filter

Inputs: limit, state, theme, product.

list_event_logB
Read-onlyIdempotent

List recent event log entries (fired events and their processing status)

Inputs: limit, state, event_name.

list_event_registryA
Read-onlyIdempotent

List registered event definitions in the ServiceNow event registry

Inputs: limit, query.

list_flow_executionsA
Read-onlyIdempotent

List recent executions of a flow with status (completed, error, running)

Inputs: flow_sys_id (required), limit, status.

list_flowsA
Read-onlyIdempotent

List Flow Designer flows with optional filter by name, category, or active status

Inputs: limit, query, active, category.

list_grc_entitiesA
Read-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_indicatorsA
Read-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_issuesA
Read-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_groupsA
Read-onlyIdempotent

List groups with optional search filter

Inputs: limit, query.

list_homepagesA
Read-onlyIdempotent

List homepage dashboards (CMS content pages used as homepages)

Inputs: limit, query.

list_hr_casesA
Read-onlyIdempotent

List HR cases with optional filters (status, subject person, service)

Inputs: limit, query, state, hr_service, +1 more.

list_hr_document_templatesA
Read-onlyIdempotent

List available HR document templates (offer letters, contracts, policies)

Inputs: limit, active, category.

list_hr_servicesA
Read-onlyIdempotent

List available HR services (Onboarding, Offboarding, Benefits, Payroll, etc.)

Inputs: limit, query, active.

list_hr_tasksA
Read-onlyIdempotent

List HR tasks associated with an HR case

Inputs: hr_case_sysid (required), state.

list_import_setsB
Read-onlyIdempotent

List Import Sets with optional filter by state or staging table

Inputs: limit, query, state.

list_indicator_resultsA
Read-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_instancesA
Read-onlyIdempotent

List all configured ServiceNow instances (multi-instance / multi-customer support)

Inputs: no named parameters.

list_integration_implementationsA
Read-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_logsA
Read-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_parametersA
Read-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_runsA
Read-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_integrationsA
Read-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_historyA
Read-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_basesB
Read-onlyIdempotent

List all knowledge bases available in the instance

Inputs: limit.

list_license_positionsA
Read-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_contextsA
Read-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_issuesB
Read-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_serversA
Read-onlyIdempotent

List MID servers and verify they are healthy

Inputs: active_only.

list_mobile_app_configsB
Read-onlyIdempotent

List sys_sg_mobile_application definitions, not installed client usage. This model has no active column.

Inputs: limit.

list_mobile_appletsB
Read-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_layoutsC
Read-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_tasksA
Read-onlyIdempotent

List tasks assigned to the currently configured user

Inputs: limit.

list_notificationsA
Read-onlyIdempotent

List email notification definitions (sysevent_email_action)

Inputs: event, limit, query, table, +1 more.

list_notification_subscriptionsA
Read-onlyIdempotent

List user subscriptions to notifications (who has opted in/out)

Inputs: limit, user_sys_id, notification_sys_id.

list_nvd_entriesA
Read-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_applicationsA
Read-onlyIdempotent

List OAuth application registry entries (client applications that can authenticate)

Inputs: limit, query.

list_pa_breakdownsA
Read-onlyIdempotent

List PA breakdowns (dimensions) available for segmenting indicator data

Inputs: limit, query.

list_pa_dashboardsB
Read-onlyIdempotent

List Performance Analytics dashboards

Inputs: limit, query.

list_pa_indicatorsA
Read-onlyIdempotent

List Performance Analytics (PA) indicators (KPIs) available in the instance

Inputs: limit, query, active, category.

list_pa_jobsC
Read-onlyIdempotent

List Performance Analytics data collection jobs and their schedules

Inputs: limit, query, active.

list_policy_exceptionsB
Read-onlyIdempotent

List Policy Exceptions (sn_compliance_policy_exception). Filter by state.

Inputs: limit, query, state, policy, +1 more.

list_portal_pagesA
Read-onlyIdempotent

List pages that belong to a Service Portal

Inputs: portal_sys_id (required), limit, query.

list_portalsA
Read-onlyIdempotent

List all Service Portal configurations available in the instance

Inputs: limit, query.

list_portal_themesA
Read-onlyIdempotent

List Service Portal themes (color palettes, CSS variables)

Inputs: limit.

list_portal_widgetsA
Read-onlyIdempotent

List Service Portal widgets with optional search by name or category

Inputs: limit, query.

list_process_automationsC
Read-onlyIdempotent

List Process Automation Designer playbooks and processes

Inputs: limit, query, active.

list_property_categoriesA
Read-onlyIdempotent

List all unique property categories with their record counts

Inputs: no named parameters.

list_relationshipsA
Read-onlyIdempotent

Show parent and child relationships for a CI

Inputs: ci_sys_id (required).

list_remediation_slaA
Read-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_findingsA
Read-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_tasksA
Read-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_reportsA
Read-onlyIdempotent

List saved reports in the instance (latest release: /api/now/reporting)

Inputs: limit, search, category.

list_request_itemsB
Read-onlyIdempotent

List requested items (sc_req_item) for a given request or catalog item

Inputs: limit, stage, request_sysid, cat_item_sysid.

list_requestsB
Read-onlyIdempotent

List service catalog requests (sc_request). Supports filtering by state and requested_for user.

Inputs: limit, query, state, requested_for.

list_rest_message_functionsA
Read-onlyIdempotent

List HTTP methods (functions) defined within a REST Message

Inputs: rest_message_sys_id (required), limit.

list_rest_messagesA
Read-onlyIdempotent

List outbound REST Message configurations (integrations with external APIs)

Inputs: limit, query.

list_risk_criteriaA
Read-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_risksA
Read-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_statementsB
Read-onlyIdempotent

List the Risk Statement library (sn_risk_definition) — reusable risk descriptions referenced by Risk records.

Inputs: name, limit.

list_scheduled_jobsA
Read-onlyIdempotent

List scheduled jobs and their run schedules

Inputs: limit, query, active.

list_scoped_appsA
Read-onlyIdempotent

List scoped applications (custom apps) installed in the instance

Inputs: limit, query, active.

list_script_includesA
Read-onlyIdempotent

List script includes (requires SCRIPTING_ENABLED=true)

Inputs: limit, query, active.

list_scrum_tasksA
Read-onlyIdempotent

List scrum tasks, optionally filtered by story

Inputs: limit, assigned_to, story_sys_id.

list_security_incidentsB
Read-onlyIdempotent

List security incidents with filters (severity, state, category)

Inputs: limit, query, state, category, +1 more.

list_security_playbooksA
Read-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_functionsA
Read-onlyIdempotent

List SOAP Message Functions (operations) for a given SOAP Message

Inputs: soap_message_sys_id (required), limit.

list_soap_messagesA
Read-onlyIdempotent

List outbound SOAP Message configurations (sys_soap_message). Endpoints live on each function, not the message.

Inputs: limit, query.

list_software_discovery_modelsC
Read-onlyIdempotent

List normalized software discovery models (raw discovery output before/after normalization)

Inputs: limit, approved, publisher.

list_software_installsB
Read-onlyIdempotent

List discovered software installations with publisher, version, and license status

Inputs: limit, query, product, publisher, +1 more.

list_software_licensesA
Read-onlyIdempotent

List software license records with compliance status

Inputs: limit, query.

list_software_lifecycle_entriesB
Read-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_reportsB
Read-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_modelsB
Read-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_productsC
Read-onlyIdempotent

List the normalized software product catalog (publisher, product type)

Inputs: name, limit, publisher.

list_storiesB
Read-onlyIdempotent

List agile stories with optional sprint or state filter

Inputs: limit, state, sprint.

list_subflowsA
Read-onlyIdempotent

List available subflows that can be reused across flows

Inputs: limit, query, active.

list_system_propertiesC
Read-onlyIdempotent

List system properties with optional filtering

Inputs: type, limit, query, category.

list_transform_field_mapsA
Read-onlyIdempotent

List field-level mappings within a Transform Map

Inputs: transform_map_sys_id (required), limit.

list_transform_mapsB
Read-onlyIdempotent

List Transform Maps used for importing data into ServiceNow tables

Inputs: limit, query, target_table.

list_ui_actionsA
Read-onlyIdempotent

List UI Actions (buttons, context menus, related links) for a table (requires SCRIPTING_ENABLED=true)

Inputs: type, limit, table, active.

list_uib_componentsB
Read-onlyIdempotent

List available UI Builder components (macroponents) in the instance

Inputs: limit, scope.

list_uib_data_brokersA
Read-onlyIdempotent

List UI Builder data brokers (data sources for pages)

Inputs: limit, page_sys_id.

list_uib_pagesA
Read-onlyIdempotent

List UI Builder pages and their route configurations

Inputs: app, limit.

list_ui_policiesA
Read-onlyIdempotent

List UI Policies for a table (field visibility, mandatory, read-only rules) (requires SCRIPTING_ENABLED=true)

Inputs: limit, table, active.

list_update_setsB
Read-onlyIdempotent

List Update Sets by state (in progress, complete, ignore)

Inputs: limit, query, state.

list_usem_rulesA
Read-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_usersB
Read-onlyIdempotent

List users with optional search filter

Inputs: limit, query.

list_ux_appsA
Read-onlyIdempotent

List Next Experience (UI Builder) applications

Inputs: limit, query.

list_ux_pagesB
Read-onlyIdempotent

List pages within a Next Experience (UI Builder) application

Inputs: app_sys_id (required), limit, query.

list_va_categoriesA
Read-onlyIdempotent

List Virtual Agent topic categories

Inputs: limit.

list_va_conversationsA
Read-onlyIdempotent

List recent Virtual Agent conversations

Inputs: limit, user_sys_id, topic_sys_id.

list_va_topics_fullB
Read-onlyIdempotent

List all Virtual Agent topics with category and status details

Inputs: limit, query, active, category.

list_vr_approvalsA
Read-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_requestsA
Read-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_notificationsA
Read-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_vulnerabilitiesA
Read-onlyIdempotent

List vulnerability entries from the Vulnerability Response module

Inputs: limit, query, state, ci_sysid, +1 more.

list_vulnerability_groupsA
Read-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_itemsA
Read-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_instancesB
Read-onlyIdempotent

List instances of a specific widget placed on portal pages

Inputs: widget_sys_id (required), limit.

list_workspacesA
Read-onlyIdempotent

List legacy Agent Workspace definitions (sys_aw_master_config), not Configurable Workspace UX applications

Inputs: limit, active.

ml_detect_anomaliesB
Read-onlyIdempotent

Run anomaly detection on operational metrics (alert volume, incident trends, etc.)

Inputs: field (required), table (required), days, threshold.

ml_evaluate_modelA
Read-onlyIdempotent

Get accuracy, training status, and metrics for a trained ML solution

Inputs: model_sys_id (required).

ml_forecast_incidentsA
Read-onlyIdempotent

Forecast incident volume for the next N days based on historical trends

Inputs: category, priority, days_ahead.

ml_model_training_historyA
Read-onlyIdempotent

Get training run history and accuracy trends for an ML solution over time

Inputs: model_sys_id (required), days.

ml_predict_change_riskA
Read-onlyIdempotent

Predict the risk level of a change request using historical ML analysis

Inputs: type, category, change_sys_id.

ml_process_optimizationB
Read-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_nluA
Read-onlyIdempotent

Analyse Virtual Agent NLU performance — conversation completion rates and fallback metrics

Inputs: days, topic_sys_id.

natural_language_updateA
Idempotent

Update a record using natural language (experimental, requires WRITE_ENABLED=true)

Inputs: table (required), instruction (required).

nlq_queryB
Read-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_setB
Read-onlyIdempotent

Preview all changes contained in an Update Set

Inputs: sys_id (required), limit.

publish_changesetA
Destructive

Publish/export an update set to XML for deployment (requires SCRIPTING_ENABLED=true)

Inputs: sys_id (required).

publish_flowA
Idempotent

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_articleA
Idempotent

Publish a draft knowledge article (requires WRITE_ENABLED=true)

Inputs: sys_id (required).

query_recordsB
Read-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_requestA
Idempotent

Reject a pending approval request (requires WRITE_ENABLED=true)

Inputs: sys_id (required), comments (required).

remove_user_from_groupA
Destructive

Remove a user from a group (requires WRITE_ENABLED=true)

Inputs: member_sys_id (required).

resolve_incidentA
Destructive

Resolve an incident with resolution code and notes (requires WRITE_ENABLED=true)

Inputs: sys_id (required), resolution_code (required), resolution_notes (required).

resolve_problemA
Destructive

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_recordB
Destructive

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_assetA
Destructive

Retire an IT asset (mark as disposed/retired). [Write]

Inputs: sys_id (required), disposal_date, disposal_reason.

retire_knowledge_articleA
Destructive

[Write] Retire a knowledge article (mark as outdated)

Inputs: article_id (required).

review_update_set_best_practicesA
Read-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_deploymentA
Destructive

Rollback a deployment by reverting an update set. [Write]

Inputs: update_set_sys_id (required), reason.

run_aggregate_queryB
Read-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_catalogA
Read-onlyIdempotent

Search the service catalog for items matching a keyword

Inputs: query (required), limit.

search_cmdb_ciB
Read-onlyIdempotent

Search for configuration items (CIs) in the CMDB

Inputs: limit, query.

search_knowledgeA
Read-onlyIdempotent

Search knowledge base articles by keyword

Inputs: query (required), limit, knowledge_base.

search_store_appsA
Read-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_propertiesA
Read-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_summaryA
Read-onlyIdempotent

View service dependencies and related CIs for impact analysis

Inputs: service_sys_id (required).

set_archive_rule_activeA
Idempotent

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_activeA
Destructive

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_activeA
Destructive

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_activeA
Idempotent

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_commitmentA
Idempotent

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_propertyB
Idempotent

Create or update a ServiceNow system property value. [Write]

Inputs: name (required), value (required), type, description.

set_usem_rule_activeA
Idempotent

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_queryA
Read-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_approvalA
Idempotent

Move a change request to "Requested" state for approval (requires WRITE_ENABLED=true)

Inputs: sys_id (required).

suggest_resolutionA
Read-onlyIdempotent

Get AI-powered resolution suggestion for an incident based on similar past incidents

Inputs: incident_sys_id (required).

switch_instanceA
Idempotent

Switch the active ServiceNow instance for this session

Inputs: name (required).

switch_update_setA
Idempotent

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_queryB
Read-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_aclA
Idempotent

Update an existing ACL rule (requires SCRIPTING_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_alertA
Idempotent

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_assetC
Idempotent

Update an IT asset record. [Write]

Inputs: fields (required), sys_id (required).

update_business_ruleB
Idempotent

Update a business rule (requires SCRIPTING_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_catalog_itemB
Idempotent

Update an existing catalog item (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_change_requestB
Idempotent

Update fields on a change request (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_client_scriptB
Idempotent

Update an existing client script (requires SCRIPTING_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_compliance_controlA
Idempotent

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_policyB
Idempotent

Update a Compliance Policy by sys_id. [Write — requires WRITE_ENABLED=true]

Inputs: fields (required), sys_id (required).

update_csm_caseA
Idempotent

Update fields on an existing CSM case (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_dashboardB
Idempotent

Update an existing PA dashboard (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_epicA
Idempotent

Update an epic (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_grc_entityB
Idempotent

Update a GRC Entity by sys_id. [Write — requires WRITE_ENABLED=true]

Inputs: fields (required), sys_id (required).

update_grc_indicatorA
Idempotent

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_issueB
Idempotent

Update a GRC Issue by sys_id. [Write — requires WRITE_ENABLED=true]

Inputs: fields (required), sys_id (required).

update_groupA
Idempotent

Update a group (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_hr_caseB
Idempotent

Update fields on an existing HR case (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_hr_profileA
Idempotent

Update HR profile fields for a user (requires WRITE_ENABLED=true)

Inputs: fields (required), user_sys_id (required).

update_incidentA
Idempotent

Update fields on an existing incident (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_knowledge_articleB
Idempotent

Update a knowledge article (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_notificationA
Idempotent

Update an existing email notification (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_portal_widgetA
Idempotent

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_problemB
Idempotent

Update fields on an existing problem (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_remediation_taskA
Idempotent

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_reportB
Idempotent

Update an existing saved report definition (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_request_itemA
Idempotent

Update a requested item — stage, assignment, or work notes (requires WRITE_ENABLED=true)

Inputs: sys_id (required), stage, state, work_notes, +2 more.

update_riskA
Idempotent

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_jobB
Idempotent

Update a scheduled job (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_scoped_appB
Idempotent

Update an existing scoped application (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_script_includeA
Idempotent

Update a script include (requires SCRIPTING_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_scrum_taskB
Idempotent

Update a scrum task (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_security_incidentB
Idempotent

Update a security incident record (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_storyB
Idempotent

Update an agile story (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_taskB
Idempotent

Update fields on a task record (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_ui_actionB
Idempotent

Update an existing UI Action (requires SCRIPTING_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_uib_componentC
Idempotent

Update a UI Builder component. [Scripting]

Inputs: sys_id (required), label, description.

update_uib_pageC
Idempotent

Update an existing UI Builder page. [Write]

Inputs: sys_id (required), path, title, layout.

update_usem_ruleA
Idempotent

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_userB
Idempotent

Update a user account (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_va_topicC
Idempotent

Update a Virtual Agent topic properties. [Write]

Inputs: fields (required), sys_id (required).

update_vulnerabilityA
Idempotent

Update a vulnerability entry (state, risk acceptance notes, remediation date) (requires WRITE_ENABLED=true)

Inputs: fields (required), sys_id (required).

update_vulnerability_groupA
Idempotent

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_artifactB
Idempotent

Validate an artifact for best practices, security issues, and performance concerns

Inputs: table (required), sys_id (required).

validate_deploymentA
Idempotent

Pre-validate an update set or app before deployment — check for conflicts and missing dependencies

Inputs: app_sys_id, update_set_sys_id.

validate_propertyA
Idempotent

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

    B3/5.0

    Scored across 503 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to interact with ServiceNow through MCP, providing schema inspection, record CRUD, attachments, audit, Flow Designer, and platform investigations with policy-guarded access.
      15
      4,188 PyPI
      4
      MIT