MCP Server

PrismHR MCP MCP Server

Name: PrismHR MCP MCP Server
Author: io.github.nikulk2992-jpg

io.github.nikulk2992-jpg/prismhr-mcp

Repository Registry

What is the PrismHR MCP MCP server?

Open-source MCP server for PrismHR. PEO workflow tools + Microsoft 365 connectors.

How to install PrismHR MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PRISMHR_MCP_ENVIRONMENT
Target environment. 'uat' (default) or 'prod' (requires PRISMHR_MCP_ALLOW_PROD=true).
PRISMHR_MCP_PEO_ID
required
PrismHR PEO identifier. Ask your PrismHR admin for the value assigned to your web service user.
PRISMHR_MCP_USERNAME
PrismHR API username. Alternatively use 1Password via PRISMHR_MCP_ONEPASSWORD_VAULT + PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR.
PRISMHR_MCP_PASSWORD
secret
PrismHR API password. Alternatively use 1Password.
PRISMHR_MCP_ONEPASSWORD_VAULT
1Password vault name (requires op CLI signed in). Overridden by direct USERNAME/PASSWORD.
PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR
1Password item name containing PrismHR credentials.
PRISMHR_MCP_ALLOW_PROD
Must be 'true' to allow PRISMHR_MCP_ENVIRONMENT=prod. Safety default keeps first-run posture on UAT.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "prismhr-mcp": {
      "command": "uvx",
      "args": [
        "prismhr-mcp"
      ],
      "env": {
        "PRISMHR_MCP_ENVIRONMENT": "<YOUR_PRISMHR_MCP_ENVIRONMENT>",
        "PRISMHR_MCP_PEO_ID": "<YOUR_PRISMHR_MCP_PEO_ID>",
        "PRISMHR_MCP_USERNAME": "<YOUR_PRISMHR_MCP_USERNAME>",
        "PRISMHR_MCP_PASSWORD": "<YOUR_PRISMHR_MCP_PASSWORD>",
        "PRISMHR_MCP_ONEPASSWORD_VAULT": "<YOUR_PRISMHR_MCP_ONEPASSWORD_VAULT>",
        "PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR": "<YOUR_PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR>",
        "PRISMHR_MCP_ALLOW_PROD": "<YOUR_PRISMHR_MCP_ALLOW_PROD>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "prismhr-mcp": {
      "command": "uvx",
      "args": [
        "prismhr-mcp"
      ],
      "env": {
        "PRISMHR_MCP_ENVIRONMENT": "<YOUR_PRISMHR_MCP_ENVIRONMENT>",
        "PRISMHR_MCP_PEO_ID": "<YOUR_PRISMHR_MCP_PEO_ID>",
        "PRISMHR_MCP_USERNAME": "<YOUR_PRISMHR_MCP_USERNAME>",
        "PRISMHR_MCP_PASSWORD": "<YOUR_PRISMHR_MCP_PASSWORD>",
        "PRISMHR_MCP_ONEPASSWORD_VAULT": "<YOUR_PRISMHR_MCP_ONEPASSWORD_VAULT>",
        "PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR": "<YOUR_PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR>",
        "PRISMHR_MCP_ALLOW_PROD": "<YOUR_PRISMHR_MCP_ALLOW_PROD>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "prismhr-mcp": {
      "command": "uvx",
      "args": [
        "prismhr-mcp"
      ],
      "env": {
        "PRISMHR_MCP_ENVIRONMENT": "<YOUR_PRISMHR_MCP_ENVIRONMENT>",
        "PRISMHR_MCP_PEO_ID": "<YOUR_PRISMHR_MCP_PEO_ID>",
        "PRISMHR_MCP_USERNAME": "<YOUR_PRISMHR_MCP_USERNAME>",
        "PRISMHR_MCP_PASSWORD": "<YOUR_PRISMHR_MCP_PASSWORD>",
        "PRISMHR_MCP_ONEPASSWORD_VAULT": "<YOUR_PRISMHR_MCP_ONEPASSWORD_VAULT>",
        "PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR": "<YOUR_PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR>",
        "PRISMHR_MCP_ALLOW_PROD": "<YOUR_PRISMHR_MCP_ALLOW_PROD>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "prismhr-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "prismhr-mcp"
      ],
      "env": {
        "PRISMHR_MCP_ENVIRONMENT": "<YOUR_PRISMHR_MCP_ENVIRONMENT>",
        "PRISMHR_MCP_PEO_ID": "<YOUR_PRISMHR_MCP_PEO_ID>",
        "PRISMHR_MCP_USERNAME": "<YOUR_PRISMHR_MCP_USERNAME>",
        "PRISMHR_MCP_PASSWORD": "<YOUR_PRISMHR_MCP_PASSWORD>",
        "PRISMHR_MCP_ONEPASSWORD_VAULT": "<YOUR_PRISMHR_MCP_ONEPASSWORD_VAULT>",
        "PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR": "<YOUR_PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR>",
        "PRISMHR_MCP_ALLOW_PROD": "<YOUR_PRISMHR_MCP_ALLOW_PROD>"
      }
    }
  }
}

Claude Code

claude mcp add prismhr-mcp --env PRISMHR_MCP_ENVIRONMENT=<YOUR_PRISMHR_MCP_ENVIRONMENT> --env PRISMHR_MCP_PEO_ID=<YOUR_PRISMHR_MCP_PEO_ID> --env PRISMHR_MCP_USERNAME=<YOUR_PRISMHR_MCP_USERNAME> --env PRISMHR_MCP_PASSWORD=<YOUR_PRISMHR_MCP_PASSWORD> --env PRISMHR_MCP_ONEPASSWORD_VAULT=<YOUR_PRISMHR_MCP_ONEPASSWORD_VAULT> --env PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR=<YOUR_PRISMHR_MCP_ONEPASSWORD_ITEM_PRISMHR> --env PRISMHR_MCP_ALLOW_PROD=<YOUR_PRISMHR_MCP_ALLOW_PROD> -- uvx prismhr-mcp