Skip to content
MCP server

HaloPSA MCP

HaloPSA ticket triage, SLA-breach pre-emption, and cross-client analytics for any MCP…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.26
Listing updated
4 days ago

About HaloPSA MCP

HaloPSA MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

HaloPSA ticket triage, SLA-breach pre-emption, and cross-client analytics for any MCP agent.

Install

Run in a terminal

claude mcp add halopsa-mcp --env HALOPSA_CLIENT_ID='<HALOPSA_CLIENT_ID>' --env HALOPSA_CLIENT_SECRET='<HALOPSA_CLIENT_SECRET>' --env HALOPSA_OAUTH_SCOPE='<HALOPSA_OAUTH_SCOPE>' --env HALOPSA_TENANT='<HALOPSA_TENANT>' --env HALOPSA_TOKEN='<HALOPSA_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.26/halopsa-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "halopsa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.26/halopsa-mcp.mcpb"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>",
        "HALOPSA_OAUTH_SCOPE": "<HALOPSA_OAUTH_SCOPE>",
        "HALOPSA_TENANT": "<HALOPSA_TENANT>",
        "HALOPSA_TOKEN": "<HALOPSA_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "halopsa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.26/halopsa-mcp.mcpb"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>",
        "HALOPSA_OAUTH_SCOPE": "<HALOPSA_OAUTH_SCOPE>",
        "HALOPSA_TENANT": "<HALOPSA_TENANT>",
        "HALOPSA_TOKEN": "<HALOPSA_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "halopsa-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.26/halopsa-mcp.mcpb"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>",
        "HALOPSA_OAUTH_SCOPE": "<HALOPSA_OAUTH_SCOPE>",
        "HALOPSA_TENANT": "<HALOPSA_TENANT>",
        "HALOPSA_TOKEN": "<HALOPSA_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "halopsa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.26/halopsa-mcp.mcpb"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>",
        "HALOPSA_OAUTH_SCOPE": "<HALOPSA_OAUTH_SCOPE>",
        "HALOPSA_TENANT": "<HALOPSA_TENANT>",
        "HALOPSA_TOKEN": "<HALOPSA_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "halopsa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.26/halopsa-mcp.mcpb"
      ],
      "env": {
        "HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
        "HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>",
        "HALOPSA_OAUTH_SCOPE": "<HALOPSA_OAUTH_SCOPE>",
        "HALOPSA_TENANT": "<HALOPSA_TENANT>",
        "HALOPSA_TOKEN": "<HALOPSA_TOKEN>"
      }
    }
  }
}

Configuration

  • HALOPSA_BASE_URLFull API base URL. Leave blank: the CLI builds it from HALOPSA_TENANT and HALOPSA_DOMAIN. Set it only to point at a different host.
  • HALOPSA_CLIENT_IDOAuth2 client_credentials ID from Configuration → Integrations → Halo PSA API.Required
  • HALOPSA_CLIENT_SECRETOAuth2 client_credentials secret.Required
  • HALOPSA_DOMAINDomain template variable. Defaults to halopsa.com.
  • HALOPSA_OAUTH_SCOPESets HALOPSA_OAUTH_SCOPE for the HaloPSA MCP server. Required by the generated client for credential refresh or hand-written auth flow.Required
  • HALOPSA_SCOPEOptional. OAuth2 scope (defaults to "all"); set to a narrower scope when your API application requires it
  • HALOPSA_TENANTYour HaloPSA tenant identifier.Required
  • HALOPSA_TOKENOptional. Pre-issued Bearer access token. Overrides the client_credentials flow when set.
  • HALOPSA_TOKEN_URLToken endpoint the client-credentials exchange posts to. Leave blank: the CLI derives it from the base URL.
  • HALOPSA_NO_CONFIG_WRITESet to 1 to keep credentials off disk. The token cache becomes a no-op, so the connector mints a fresh token each run instead of writing one to config.toml. Leave blank for the default cached behaviour.
  • HALOPSA_MCP_READ_ONLYOptional. Set to 1 to list only read-only tools.

Pricing

Open source

HaloPSA MCP FAQ

Is HaloPSA MCP free?

Yes. HaloPSA MCP is open source, so you can use and self-host it for free.

How do I add HaloPSA MCP to Claude Code?

Run this command in your terminal: claude mcp add halopsa-mcp --env HALOPSA_CLIENT_ID='<HALOPSA_CLIENT_ID>' --env HALOPSA_CLIENT_SECRET='<HALOPSA_CLIENT_SECRET>' --env HALOPSA_OAUTH_SCOPE='<HALOPSA_OAUTH_SCOPE>' --env HALOPSA_TENANT='<HALOPSA_TENANT>' --env HALOPSA_TOKEN='<HALOPSA_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/halopsa-v0.2.26/halopsa-mcp.mcpb