Don't script your AI. Arm it.

Tell your AI what you need in plain language. MCP Skills handle the rest.

mfa-servicenow-mcp

Quick Start

Just paste this. That's it.

Copy the line below into any AI coding assistant.
It installs everything — uv, Playwright, MCP config, and skills — automatically.

Install and configure mfa-servicenow-mcp by following the instructions here:
curl -s https://raw.githubusercontent.com/jshsakura/mfa-servicenow-mcp/main/docs/llm-setup.md

Works with Claude Code, Cursor, Codex, OpenCode, Windsurf, VS Code Copilot, Gemini CLI, Zed, and more.
Your AI detects the client and OS, then walks you through setup interactively.
After setup, restart your AI client to load the MCP server.

Manual — One command installer

Run setup for your client

Prefer to do it yourself in the terminal? Use the installer below. It writes the right MCP config for your client, preserves existing settings, and installs skills when supported.

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Configure your client and install optional skills
uvx --with playwright --from mfa-servicenow-mcp servicenow-mcp setup opencode \
  --instance-url "https://your-instance.service-now.com" \
  --auth-type "browser"

# Install uv (if not already installed)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Configure your client and install optional skills
uvx --with playwright --from mfa-servicenow-mcp servicenow-mcp setup opencode `
  --instance-url "https://your-instance.service-now.com" `
  --auth-type "browser"

# Install with pip + browser auth support
pip install "mfa-servicenow-mcp[browser]"
playwright install chromium

# Run with MFA browser login
servicenow-mcp \
  --instance-url "https://your-instance.service-now.com" \
  --auth-type "browser" \
  --browser-headless "false"

# Clone and install in development mode
git clone https://github.com/jshsakura/mfa-servicenow-mcp.git
cd mfa-servicenow-mcp
uv pip install -e ".[browser]"
playwright install chromium

# Run with MFA browser login
servicenow-mcp \
  --instance-url "https://your-instance.service-now.com" \
  --auth-type "browser" \
  --browser-headless "false"

Manual fallback

Repair or inspect client config manually

The installer is the recommended path. Use the raw config examples below only if you need to inspect or repair a client config by hand.

{
  "mcpServers": {
    "servicenow": {
      "command": "uvx",
      "args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_AUTH_TYPE": "browser",
        "SERVICENOW_BROWSER_HEADLESS": "false",
        "SERVICENOW_USERNAME": "your.username",
        "SERVICENOW_PASSWORD": "your-password",
        "MCP_TOOL_PACKAGE": "standard"
      }
    }
  }
}

{
  "mcpServers": {
    "servicenow": {
      "command": "uvx",
      "args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_AUTH_TYPE": "browser",
        "SERVICENOW_BROWSER_HEADLESS": "false",
        "SERVICENOW_USERNAME": "your.username",
        "SERVICENOW_PASSWORD": "your-password",
        "MCP_TOOL_PACKAGE": "standard"
      }
    }
  }
}

[mcp_servers.servicenow]
command = "uvx"
args = ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"]
enabled = true

[mcp_servers.servicenow.env]
SERVICENOW_INSTANCE_URL = "https://your-instance.service-now.com"
SERVICENOW_AUTH_TYPE = "browser"
SERVICENOW_BROWSER_HEADLESS = "false"
SERVICENOW_USERNAME = "your-username"
SERVICENOW_PASSWORD = "your-password"
MCP_TOOL_PACKAGE = "full"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servicenow": {
      "type": "local",
      "command": [
        "uvx", "--with", "playwright",
        "--from", "mfa-servicenow-mcp", "servicenow-mcp"
      ],
      "enabled": true,
      "environment": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_AUTH_TYPE": "browser",
        "SERVICENOW_BROWSER_HEADLESS": "false",
        "SERVICENOW_USERNAME": "your.username",
        "SERVICENOW_PASSWORD": "your-password",
        "MCP_TOOL_PACKAGE": "standard"
      }
    }
  }
}

{
  "mcpServers": {
    "servicenow": {
      "command": "uvx",
      "args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_AUTH_TYPE": "browser",
        "SERVICENOW_BROWSER_HEADLESS": "false",
        "SERVICENOW_USERNAME": "your.username",
        "SERVICENOW_PASSWORD": "your-password",
        "MCP_TOOL_PACKAGE": "standard"
      }
    }
  }
}

{
  "mcpServers": {
    "servicenow": {
      "command": "uvx",
      "args": [
        "--with", "playwright",
        "--from", "mfa-servicenow-mcp",
        "servicenow-mcp"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_AUTH_TYPE": "browser",
        "SERVICENOW_BROWSER_HEADLESS": "false",
        "SERVICENOW_USERNAME": "your.username",
        "SERVICENOW_PASSWORD": "your-password",
        "MCP_TOOL_PACKAGE": "standard"
      }
    }
  }
}

Manual — Step 3

Add LLM-optimized skills

Tools alone are raw API calls. Skills are what make your LLM actually useful — verified pipelines with safety gates, rollback, and context-aware delegation. 24 skills today, more coming with every release.

uvx --from mfa-servicenow-mcp servicenow-mcp-skills claude

uvx --from mfa-servicenow-mcp servicenow-mcp-skills codex

uvx --from mfa-servicenow-mcp servicenow-mcp-skills opencode

uvx --from mfa-servicenow-mcp servicenow-mcp-skills gemini

🔍 analyze/

6 skills — widget analysis, portal diagnosis, dependency mapping, code detection

🔧 fix/

3 skills — widget patching with staged safety gates, debugging, code review

📦 manage/

5 skills — page layout, script includes, source export, changeset workflow

🚀 deploy/

2 skills — change request lifecycle, incident triage

🧭 explore/

4 skills — health check, schema discovery, route tracing, ESC catalog flow

Keeping Up to Date

Always run the latest version

uvx caches the last downloaded version — it does not auto-update.
Upgrade via uv to get the latest release:

uvx --refresh --from mfa-servicenow-mcp servicenow-mcp --version

Then restart your MCP client (Claude Code, Cursor, etc.) to load the new version.

150+ MCP Tools

MFA Native Support

5 Skill Categories

0 Credentials Shared

How it works

Three steps to production

No API keys to configure, no passwords in config files. Authenticate once through your browser, and your AI agent inherits a live session.

1

Install

One command with uvx sets everything up. Zero config.

2

Authenticate

A real browser opens for MFA, SSO, SAML — whatever your org requires.

3

Connect

Point Claude, Cursor, or any MCP client. 110+ packaged tools ready instantly.

Features

Built for the enterprise

Everything you need to bridge AI agents and ServiceNow securely at scale.

🔒 Zero-Trust Security

Browser-based auth means credentials never leave your machine. Supports MFA, SSO, SAML, and any login flow your org uses.

⚡ Optimized Performance

Batch queries, connection pooling, response caching, and token-efficient JSON keep latency and API costs to a minimum.

🧩 Modular Skill Packages

Incidents, Changes, Catalog, Portals, Workflows, and Scripts — load only what you need or run the full suite.

🤖 Multi-LLM Compatible

Works with Claude, ChatGPT, Gemini, Cursor, and any client that speaks the Model Context Protocol.