HaloPSA
MCP server for HaloPSA — clients, tickets, and PSA workflows via the HaloPSA REST API.
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.7.11
- Listing updated
- 6 days ago
About HaloPSA
HaloPSA is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add halopsa-mcp --env HALOPSA_CLIENT_ID='<HALOPSA_CLIENT_ID>' --env HALOPSA_CLIENT_SECRET='<HALOPSA_CLIENT_SECRET>' -- docker run -i --rm -e HALOPSA_CLIENT_ID -e HALOPSA_CLIENT_SECRET ghcr.io/wyre-technology/halopsa-mcp:v1.7.11Add to claude_desktop_config.json
{
"mcpServers": {
"halopsa-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HALOPSA_CLIENT_ID",
"-e",
"HALOPSA_CLIENT_SECRET",
"ghcr.io/wyre-technology/halopsa-mcp:v1.7.11"
],
"env": {
"HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
"HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"halopsa-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HALOPSA_CLIENT_ID",
"-e",
"HALOPSA_CLIENT_SECRET",
"ghcr.io/wyre-technology/halopsa-mcp:v1.7.11"
],
"env": {
"HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
"HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"halopsa-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HALOPSA_CLIENT_ID",
"-e",
"HALOPSA_CLIENT_SECRET",
"ghcr.io/wyre-technology/halopsa-mcp:v1.7.11"
],
"env": {
"HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
"HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"halopsa-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HALOPSA_CLIENT_ID",
"-e",
"HALOPSA_CLIENT_SECRET",
"ghcr.io/wyre-technology/halopsa-mcp:v1.7.11"
],
"env": {
"HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
"HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"halopsa-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HALOPSA_CLIENT_ID",
"-e",
"HALOPSA_CLIENT_SECRET",
"ghcr.io/wyre-technology/halopsa-mcp:v1.7.11"
],
"env": {
"HALOPSA_CLIENT_ID": "<HALOPSA_CLIENT_ID>",
"HALOPSA_CLIENT_SECRET": "<HALOPSA_CLIENT_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
HALOPSA_CLIENT_IDHaloPSA OAuth client IDRequiredHALOPSA_CLIENT_SECRETHaloPSA OAuth client secretRequiredHALOPSA_TENANTHaloPSA tenant identifier (subdomain). Provide this or HALOPSA_BASE_URL.HALOPSA_BASE_URLHaloPSA base URL (e.g. https://your-instance.halopsa.com). Provide this or HALOPSA_TENANT.MCP_TRANSPORTTransport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.AUTH_MODECredential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.LOG_LEVELLog verbosity: debug, info, warn, error
Pricing
Open source
HaloPSA FAQ
Is HaloPSA free?
Yes. HaloPSA is open source, so you can use and self-host it for free.
How do I add HaloPSA 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>' -- docker run -i --rm -e HALOPSA_CLIENT_ID -e HALOPSA_CLIENT_SECRET ghcr.io/wyre-technology/halopsa-mcp:v1.7.11
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.