Skip to content
MCP server

Kaseya BMS MCP

CLI and MCP server for Kaseya BMS PSA: tickets, CRM, contracts, finance, and offline…

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

About Kaseya BMS MCP

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

CLI and MCP server for Kaseya BMS PSA: tickets, CRM, contracts, finance, and offline analytics.

Install

Run in a terminal

claude mcp add kaseya-bms-mcp --env KASEYA_BMS_BEARER_AUTH='<KASEYA_BMS_BEARER_AUTH>' --env KASEYA_BMS_PASSWORD='<KASEYA_BMS_PASSWORD>' --env KASEYA_BMS_TENANT='<KASEYA_BMS_TENANT>' --env KASEYA_BMS_TOKEN='<KASEYA_BMS_TOKEN>' --env KASEYA_BMS_USERNAME='<KASEYA_BMS_USERNAME>' --env KASEYA_BMS_MCP_HTTP_TOKEN='<KASEYA_BMS_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/kaseya-bms-v0.1.14/kaseya-bms-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kaseya-bms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/kaseya-bms-v0.1.14/kaseya-bms-mcp.mcpb"
      ],
      "env": {
        "KASEYA_BMS_BEARER_AUTH": "<KASEYA_BMS_BEARER_AUTH>",
        "KASEYA_BMS_PASSWORD": "<KASEYA_BMS_PASSWORD>",
        "KASEYA_BMS_TENANT": "<KASEYA_BMS_TENANT>",
        "KASEYA_BMS_TOKEN": "<KASEYA_BMS_TOKEN>",
        "KASEYA_BMS_USERNAME": "<KASEYA_BMS_USERNAME>",
        "KASEYA_BMS_MCP_HTTP_TOKEN": "<KASEYA_BMS_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kaseya-bms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/kaseya-bms-v0.1.14/kaseya-bms-mcp.mcpb"
      ],
      "env": {
        "KASEYA_BMS_BEARER_AUTH": "<KASEYA_BMS_BEARER_AUTH>",
        "KASEYA_BMS_PASSWORD": "<KASEYA_BMS_PASSWORD>",
        "KASEYA_BMS_TENANT": "<KASEYA_BMS_TENANT>",
        "KASEYA_BMS_TOKEN": "<KASEYA_BMS_TOKEN>",
        "KASEYA_BMS_USERNAME": "<KASEYA_BMS_USERNAME>",
        "KASEYA_BMS_MCP_HTTP_TOKEN": "<KASEYA_BMS_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "kaseya-bms-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/kaseya-bms-v0.1.14/kaseya-bms-mcp.mcpb"
      ],
      "env": {
        "KASEYA_BMS_BEARER_AUTH": "<KASEYA_BMS_BEARER_AUTH>",
        "KASEYA_BMS_PASSWORD": "<KASEYA_BMS_PASSWORD>",
        "KASEYA_BMS_TENANT": "<KASEYA_BMS_TENANT>",
        "KASEYA_BMS_TOKEN": "<KASEYA_BMS_TOKEN>",
        "KASEYA_BMS_USERNAME": "<KASEYA_BMS_USERNAME>",
        "KASEYA_BMS_MCP_HTTP_TOKEN": "<KASEYA_BMS_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kaseya-bms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/kaseya-bms-v0.1.14/kaseya-bms-mcp.mcpb"
      ],
      "env": {
        "KASEYA_BMS_BEARER_AUTH": "<KASEYA_BMS_BEARER_AUTH>",
        "KASEYA_BMS_PASSWORD": "<KASEYA_BMS_PASSWORD>",
        "KASEYA_BMS_TENANT": "<KASEYA_BMS_TENANT>",
        "KASEYA_BMS_TOKEN": "<KASEYA_BMS_TOKEN>",
        "KASEYA_BMS_USERNAME": "<KASEYA_BMS_USERNAME>",
        "KASEYA_BMS_MCP_HTTP_TOKEN": "<KASEYA_BMS_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kaseya-bms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/kaseya-bms-v0.1.14/kaseya-bms-mcp.mcpb"
      ],
      "env": {
        "KASEYA_BMS_BEARER_AUTH": "<KASEYA_BMS_BEARER_AUTH>",
        "KASEYA_BMS_PASSWORD": "<KASEYA_BMS_PASSWORD>",
        "KASEYA_BMS_TENANT": "<KASEYA_BMS_TENANT>",
        "KASEYA_BMS_TOKEN": "<KASEYA_BMS_TOKEN>",
        "KASEYA_BMS_USERNAME": "<KASEYA_BMS_USERNAME>",
        "KASEYA_BMS_MCP_HTTP_TOKEN": "<KASEYA_BMS_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Configuration

  • KASEYA_BMS_BASE_URLBase URL for the Kaseya BMS API. Leave the prefilled default unless your account uses a different regional or self-hosted host.
  • KASEYA_BMS_BEARER_AUTHAlias for KASEYA_BMS_TOKEN - a pre-minted Kaseya BMS JWT sent as a Bearer token. Set one of the two, or use 'auth login'.
  • KASEYA_BMS_PASSWORDPassword for KASEYA_BMS_USERNAME. Exchanged for a JWT; never sent on data calls.Required
  • KASEYA_BMS_TENANTYour company name exactly as it appears under My Settings in BMS. The authenticate call rejects the login without it.Required
  • KASEYA_BMS_TOKENPre-minted Kaseya BMS JWT, sent as a Bearer token. Set this OR KASEYA_BMS_BEARER_AUTH; alternatively run 'kaseya-bms-cli auth login' to mint one from username/password/tenant.
  • KASEYA_BMS_USERNAMEKaseya BMS login used by `auth login` to exchange for a short-lived JWT.Required
  • KASEYA_BMS_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any state-changing execute call.
  • KASEYA_BMS_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API and the response cache is off.
  • KASEYA_BMS_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http. Not needed for the default local stdio transport.
  • KASEYA_BMS_USER_AGENTOptional. Overrides the User-Agent the CLI sends on Kaseya BMS requests. Leave blank to use the CLI's own built-in User-Agent.
  • PRINTING_PRESS_CLIENT_PROFILEOptional: binds the MCP server to an existing tenant-gated Printing Press client profile. Leave unset for a single-tenant install.

Pricing

Open source

Kaseya BMS MCP FAQ

Is Kaseya BMS MCP free?

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

How do I add Kaseya BMS MCP to Claude Code?

Run this command in your terminal: claude mcp add kaseya-bms-mcp --env KASEYA_BMS_BEARER_AUTH='<KASEYA_BMS_BEARER_AUTH>' --env KASEYA_BMS_PASSWORD='<KASEYA_BMS_PASSWORD>' --env KASEYA_BMS_TENANT='<KASEYA_BMS_TENANT>' --env KASEYA_BMS_TOKEN='<KASEYA_BMS_TOKEN>' --env KASEYA_BMS_USERNAME='<KASEYA_BMS_USERNAME>' --env KASEYA_BMS_MCP_HTTP_TOKEN='<KASEYA_BMS_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/kaseya-bms-v0.1.14/kaseya-bms-mcp.mcpb