Happy Platform MCP

Local install

io.github.nickzitzer/happy-platform-mcpv7.0.3 GitHub verified

ServiceNow MCP server: 60 tools for any table, multi-instance, natural language search

Productivity

Watch Source

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-15T16:23:57.473022Z",
      "publishedAt": "2026-11-15T16:23:57.473022Z",
      "statusChangedAt": "2026-11-15T16:23:57.473022Z"
    }
  },
  "server": {
    "name": "io.github.nickzitzer/happy-platform-mcp",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "7.0.3",
    "packages": [
      {
        "version": "7.0.3",
        "transport": {
          "type": "stdio"
        },
        "identifier": "happy-platform-mcp",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "SERVICENOW_INSTANCE_URL",
            "format": "string",
            "description": "ServiceNow instance URL (e.g., https://dev123456.service-now.com)"
          },
          {
            "name": "SERVICENOW_USERNAME",
            "format": "string",
            "description": "ServiceNow username"
          },
          {
            "name": "SERVICENOW_PASSWORD",
            "format": "string",
            "isSecret": true,
            "description": "ServiceNow password"
          },
          {
            "name": "SERVICENOW_AUTH_TYPE",
            "format": "string",
            "description": "Authentication type (default: basic)"
          },
          {
            "name": "SERVICENOW_INSTANCE",
            "format": "string",
            "description": "Specific instance name from config file (optional)"
          },
          {
            "name": "HAPPY_MCP_DOCS_ONLY",
            "format": "boolean",
            "description": "Start with only ServiceNowDocs tools. Use true for docs-only deployments without ServiceNow credentials."
          },
          {
            "name": "HAPPY_DOCS_ENABLE_LOCAL_INDEX",
            "format": "boolean",
            "description": "Enable optional local SQLite FTS indexing for ServiceNowDocs search"
          },
          {
            "name": "HAPPY_DOCS_CACHE_DIR",
            "format": "string",
            "description": "Directory for cached ServiceNowDocs markdown and SQLite index"
          },
          {
            "name": "HAPPY_DOCS_ENABLE_VECTOR",
            "format": "boolean",
            "description": "Enable optional ServiceNowDocs vector search when local indexing, sqlite-vec, and an embedding provider are available."
          },
          {
            "name": "HAPPY_DOCS_EMBEDDING_PROVIDER",
            "format": "string",
            "description": "Embedding provider for ServiceNowDocs vector search. Use local for deterministic local embeddings or none to disable embeddings."
          },
          {
            "name": "SERVICENOW_CLIENT_ID",
            "format": "string",
            "description": "OAuth client ID (when SERVICENOW_AUTH_TYPE=oauth)"
          },
          {
            "name": "SERVICENOW_CLIENT_SECRET",
            "format": "string",
            "isSecret": true,
            "description": "OAuth client secret (when SERVICENOW_AUTH_TYPE=oauth)"
          },
          {
            "name": "SERVICENOW_OAUTH_GRANT_TYPE",
            "format": "string",
            "description": "OAuth grant type (when SERVICENOW_AUTH_TYPE=oauth); passwordless grants do not need SERVICENOW_USERNAME/SERVICENOW_PASSWORD"
          },
          {
            "name": "HAPPY_CONFIG_PATH",
            "format": "string",
            "description": "Path to an instances.json multi-instance config file (optional)"
          }
        ]
      },
      {
        "transport": {
          "type": "stdio"
        },
        "identifier": "docker.io/nczitzer/happy-platform-mcp:7.0.3",
        "runtimeHint": "docker",
        "registryType": "oci",
        "packageArguments": [
          {
            "type": "positional",
            "value": "servicenow-mcp-server",
            "valueHint": "command",
            "description": "Run the stdio server; overrides the image default CMD (HTTP server on port 3000)"
          }
        ],
        "runtimeArguments": [
          {
            "name": "-i",
            "type": "named",
            "description": "Keep stdin open for the stdio transport"
          },
          {
            "name": "--rm",
            "type": "named",
            "description": "Remove the container on exit"
          }
        ],
        "environmentVariables": [
          {
            "name": "SERVICENOW_INSTANCE_URL",
            "format": "string",
            "description": "ServiceNow instance URL (e.g., https://dev123456.service-now.com)"
          },
          {
            "name": "SERVICENOW_USERNAME",
            "format": "string",
            "description": "ServiceNow username"
          },
          {
            "name": "SERVICENOW_PASSWORD",
            "format": "string",
            "isSecret": true,
            "description": "ServiceNow password"
          },
          {
            "name": "SERVICENOW_AUTH_TYPE",
            "format": "string",
            "description": "Authentication type (default: basic)"
          },
          {
            "name": "SERVICENOW_INSTANCE",
            "format": "string",
            "description": "Specific instance name from config file (optional)"
          },
          {
            "name": "HAPPY_MCP_DOCS_ONLY",
            "format": "boolean",
            "description": "Start with only ServiceNowDocs tools. Use true for docs-only deployments without ServiceNow credentials."
          },
          {
            "name": "HAPPY_DOCS_ENABLE_LOCAL_INDEX",
            "format": "boolean",
            "description": "Enable optional local SQLite FTS indexing for ServiceNowDocs search"
          },
          {
            "name": "HAPPY_DOCS_CACHE_DIR",
            "format": "string",
            "description": "Directory for cached ServiceNowDocs markdown and SQLite index"
          },
          {
            "name": "HAPPY_DOCS_ENABLE_VECTOR",
            "format": "boolean",
            "description": "Enable optional ServiceNowDocs vector search when local indexing, sqlite-vec, and an embedding provider are available."
          },
          {
            "name": "HAPPY_DOCS_EMBEDDING_PROVIDER",
            "format": "string",
            "description": "Embedding provider for ServiceNowDocs vector search. Use local for deterministic local embeddings or none to disable embeddings."
          },
          {
            "name": "SERVICENOW_CLIENT_ID",
            "format": "string",
            "description": "OAuth client ID (when SERVICENOW_AUTH_TYPE=oauth)"
          },
          {
            "name": "SERVICENOW_CLIENT_SECRET",
            "format": "string",
            "isSecret": true,
            "description": "OAuth client secret (when SERVICENOW_AUTH_TYPE=oauth)"
          },
          {
            "name": "SERVICENOW_OAUTH_GRANT_TYPE",
            "format": "string",
            "description": "OAuth grant type (when SERVICENOW_AUTH_TYPE=oauth); passwordless grants do not need SERVICENOW_USERNAME/SERVICENOW_PASSWORD"
          },
          {
            "name": "HAPPY_CONFIG_PATH",
            "format": "string",
            "description": "Path to an instances.json multi-instance config file (optional)"
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/Happy-Technologies-LLC/happy-platform-mcp",
      "source": "github"
    },
    "description": "ServiceNow MCP server: 60 tools for any table, multi-instance, natural language search"
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Run in a terminal

claude mcp add happy-platform-mcp \
  -- npx -y [email protected]

Environment

SERVICENOW_INSTANCE_URL (optional, not in the config above): ServiceNow instance URL (e.g., https://dev123456.service-now.com)
SERVICENOW_USERNAME (optional, not in the config above): ServiceNow username
SERVICENOW_PASSWORD (optional, not in the config above): ServiceNow password
SERVICENOW_AUTH_TYPE (optional, not in the config above): Authentication type (default: basic)
SERVICENOW_INSTANCE (optional, not in the config above): Specific instance name from config file (optional)
HAPPY_MCP_DOCS_ONLY (optional, not in the config above): Start with only ServiceNowDocs tools. Use true for docs-only deployments without ServiceNow credentials.
HAPPY_DOCS_ENABLE_LOCAL_INDEX (optional, not in the config above): Enable optional local SQLite FTS indexing for ServiceNowDocs search
HAPPY_DOCS_CACHE_DIR (optional, not in the config above): Directory for cached ServiceNowDocs markdown and SQLite index
HAPPY_DOCS_ENABLE_VECTOR (optional, not in the config above): Enable optional ServiceNowDocs vector search when local indexing, sqlite-vec, and an embedding provider are available.
HAPPY_DOCS_EMBEDDING_PROVIDER (optional, not in the config above): Embedding provider for ServiceNowDocs vector search. Use local for deterministic local embeddings or none to disable embeddings.
SERVICENOW_CLIENT_ID (optional, not in the config above): OAuth client ID (when SERVICENOW_AUTH_TYPE=oauth)
SERVICENOW_CLIENT_SECRET (optional, not in the config above): OAuth client secret (when SERVICENOW_AUTH_TYPE=oauth)
SERVICENOW_OAUTH_GRANT_TYPE (optional, not in the config above): OAuth grant type (when SERVICENOW_AUTH_TYPE=oauth); passwordless grants do not need SERVICENOW_USERNAME/SERVICENOW_PASSWORD
HAPPY_CONFIG_PATH (optional, not in the config above): Path to an instances.json multi-instance config file (optional)

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Run in a terminal

claude mcp add happy-platform-mcp \
  -- npx -y [email protected]

Environment

SERVICENOW_INSTANCE_URL (optional, not in the config above): ServiceNow instance URL (e.g., https://dev123456.service-now.com)
SERVICENOW_USERNAME (optional, not in the config above): ServiceNow username
SERVICENOW_PASSWORD (optional, not in the config above): ServiceNow password
SERVICENOW_AUTH_TYPE (optional, not in the config above): Authentication type (default: basic)
SERVICENOW_INSTANCE (optional, not in the config above): Specific instance name from config file (optional)
HAPPY_MCP_DOCS_ONLY (optional, not in the config above): Start with only ServiceNowDocs tools. Use true for docs-only deployments without ServiceNow credentials.
HAPPY_DOCS_ENABLE_LOCAL_INDEX (optional, not in the config above): Enable optional local SQLite FTS indexing for ServiceNowDocs search
HAPPY_DOCS_CACHE_DIR (optional, not in the config above): Directory for cached ServiceNowDocs markdown and SQLite index
HAPPY_DOCS_ENABLE_VECTOR (optional, not in the config above): Enable optional ServiceNowDocs vector search when local indexing, sqlite-vec, and an embedding provider are available.
HAPPY_DOCS_EMBEDDING_PROVIDER (optional, not in the config above): Embedding provider for ServiceNowDocs vector search. Use local for deterministic local embeddings or none to disable embeddings.
SERVICENOW_CLIENT_ID (optional, not in the config above): OAuth client ID (when SERVICENOW_AUTH_TYPE=oauth)
SERVICENOW_CLIENT_SECRET (optional, not in the config above): OAuth client secret (when SERVICENOW_AUTH_TYPE=oauth)
SERVICENOW_OAUTH_GRANT_TYPE (optional, not in the config above): OAuth grant type (when SERVICENOW_AUTH_TYPE=oauth); passwordless grants do not need SERVICENOW_USERNAME/SERVICENOW_PASSWORD
HAPPY_CONFIG_PATH (optional, not in the config above): Path to an instances.json multi-instance config file (optional)

Try it

Install

Try it

Install

Tools