Skip to main content
Back to MCP ServerNative since launch (March 2024)

Claude Desktop + WHMCS MCP Server

Ask Claude about your WHMCS clients, invoices, and tickets using plain English. 46 tools available, works on the free plan, and your data stays on your server. Setup takes under 5 minutes.

Get Started - $22/moSetup guide

What You Can Do

Claude Desktop connects to WHMCS via STDIO (via mcp-remote bridge). Access 46 tools from the desktop app.

Daily Client Lookups

Type a client email or name and get their full profile: active services, invoices (paid and overdue), open tickets, and account notes. Replaces the 4-5 clicks needed in WHMCS admin to find the same information.

Example prompt:

“Show me client details for john@example.com including their active services and recent tickets.”

Returns structured data in 2-3 seconds. You see service names, statuses, next due dates, and ticket summaries in one response.

Revenue Snapshots

Ask for MRR, ARR, or revenue by product group. Claude calculates totals from live WHMCS data. Useful for quick checks before meetings without logging into the admin panel or running custom SQL.

Example prompt:

“What is our current MRR? Show me a breakdown by product group.”

Returns a table with product groups, active service counts, and monthly recurring amounts. Totals are calculated automatically.

Ticket Triage

Pull open tickets sorted by age or department. Claude can summarize ticket threads so you can prioritize without reading each one. Helps support managers review daily ticket volume in under a minute.

Example prompt:

“List all open support tickets sorted by oldest first. Summarize the top 5.”

Returns ticket IDs, subjects, departments, age in hours, and a 1-2 sentence summary of each thread.

Bulk Data Operations

Create tickets, add client notes, or look up multiple accounts in a single conversation. Claude maintains context across tool calls, so you can chain operations like "find all clients with overdue invoices over $500 and list their domains."

Example prompt:

“Find clients with overdue invoices over $500. For each one, show their primary domain and days overdue.”

Returns a structured list. Claude chains the invoice lookup tool with the client details tool automatically.

How to Connect

Get Claude Desktop talking to your WHMCS in minutes.

1

Install MCP Server on your WHMCS

Upload the addon to your WHMCS installation, activate it, and generate a Bearer token. Takes about 5 minutes. Full installation guide

2

Configure Claude Desktop

Add your WHMCS MCP Server to Claude Desktop's config file:

{
  "mcpServers": {
    "whmcs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-whmcs.com/modules/addons/mx_mcp/mcp.php",
        "--header",
        "Authorization:Bearer YOUR_BEARER_TOKEN"
      ]
    }
  }
}

Config location: ~/Library/Application Support/Claude/claude_desktop_config.json

3

Restart and test

Restart Claude Desktop and try a simple query like “Get WHMCS system status” to verify the connection.

Detailed setup guide with troubleshooting

Example Prompts

Real queries you can ask Claude Desktop once connected to WHMCS.

1

“How many active clients do we have? Show monthly growth for the last 6 months.”

2

“List all overdue invoices over $500. Include client name and days overdue.”

3

“Get the support ticket history for client domain hostingpro.com.”

4

“Show our top 10 clients by revenue this quarter.”

5

“What products have the highest churn rate this month?”

6

“Create a support ticket for client #1042 about their scheduled server migration next week.”

7

“Compare revenue this month vs last month. Which product groups grew?”

Claude Desktop vs ChatGPT vs Cursor for WHMCS

All three support MCP Server. Here is how they compare for WHMCS operations.

FeatureClaude DesktopChatGPTCursor
MCP TransportSTDIO (local)Remote HTTP onlySTDIO + SSE
Localhost supportYesNo (public URL needed)Yes
Free tier MCPYesNo (Plus $20/mo)Community tier
MCP maturityStable since Mar 2024Beta since Sep 2025Stable since mid 2024
Max tool calls/turn53 (beta limit)Varies by model
Config methodJSON fileSettings UIJSON file
Conversation exportNo native exportShare linksIDE history

Data current as of February 2026. MCP support varies by plan and version.

Technical Details

What you need to know before setting up Claude Desktop with MCP Server.

Minimum Version
Claude Desktop 1.0+
Transport
STDIO via npx bridge
Supported OS
macOS, Windows, Linux (AppImage)
Requires Node.js
Yes (for npx bridge)
Public URL Required
No (works on localhost)
Concurrent Tool Calls
Up to 5 tool calls per turn
Response Time
2-4 seconds for simple queries, 8-15 seconds for multi-tool operations

Data Flow

How Claude Connects to WHMCS

Claude Desktop reads your WHMCS data through MCP Server. Your billing, analytics, and proposal data are available in one conversation.

MX Metrics
MX Metrics
WHMCS
WHMCS
MX Proposals
MX Proposals
MCP Server

MCP Server

AI Integration Hub

Claude

Better Together

MCP Server works with the full MX ecosystem. More modules, more data, more capabilities.

MX Metrics

With MX Metrics installed, Claude can pull revenue analytics, MRR trends, churn rates, and client lifetime value directly from your WHMCS. Ask "What is our MRR trend over the last 12 months?" and get data-backed answers.

Learn about MX Metrics →

MX Proposals

MX Proposals data becomes queryable through Claude. Ask "Show me all pending proposals over $5,000" or "Which proposals were accepted this month?" to track your sales pipeline through conversation.

Learn about MX Proposals →

How your data flows

Claude Desktop spawns a local bridge process (npx mcp-remote) that connects to your WHMCS over HTTPS. Your WHMCS database stays on your server. The bridge sends MCP tool responses to Anthropic for AI processing. Anthropic does not store conversation data on Pro plans with data retention turned off.

For maximum privacy, consider using local AI models that run entirely on your hardware. No data leaves your server.

Frequently Asked Questions

How do I connect Claude Desktop to my WHMCS?
Install the MCP Server addon on your WHMCS, generate an API key, then add the server configuration to your claude_desktop_config.json file. Claude Desktop will automatically detect the MCP server on next launch. The whole process takes about 10 minutes. See our step-by-step guide at /docs/mcp-server/integrations/claude.
Is my WHMCS data sent to Anthropic servers?
Your WHMCS database stays on your server. When Claude queries data via MCP, the bridge process (running on your machine) sends the query to your WHMCS, gets the response, and passes it to Anthropic for AI processing. Anthropic sees the MCP tool responses (the data you asked about) but never has direct access to your database. If you enable "Do not train on my data" in Claude settings, Anthropic does not retain conversation content.
Can Claude write data to WHMCS or only read?
MCP Server supports both read and write operations. The admin controls which tools are available globally (enable or disable each tool in MCP Server settings). All authenticated API keys share the same tool access. Use separate API keys for each team member or agent for audit trail purposes.
Does Claude Desktop MCP work on the free plan?
Yes. Claude Desktop supports MCP connections on all plans including free. The free plan has lower message limits (around 30 messages per 3 hours), but MCP tools work the same way. Pro ($20/month) gives significantly higher limits and priority access.
What WHMCS data can Claude access through MCP Server?
MCP Server exposes 46 tools across 9 categories: clients (search, details, contacts), invoices (list, details, overdue), tickets (list, view threads, create), products and services, orders, domains, servers, system status, and revenue analytics. Each tool returns structured data that Claude formats into readable responses.
How fast are MCP queries through Claude Desktop?
Simple queries (client lookup, system status) return in 2-4 seconds. Multi-step operations where Claude chains several tools (like finding overdue invoices and then looking up each client) take 8-15 seconds depending on data volume. The bottleneck is AI processing, not the MCP connection. The actual WHMCS query via MCP takes under 500ms.
Does it work behind a firewall or on localhost?
Yes. Claude Desktop uses STDIO transport, meaning the bridge process runs locally on your machine. If your WHMCS is accessible from your machine (even on a private network or localhost), it works. This is a key advantage over ChatGPT, which requires a public HTTPS URL.

Start using Claude Desktop with WHMCS today

Install MCP Server, configure Claude Desktop, and query your WHMCS data in plain English. Setup takes less than 15 minutes.

Get Started - $22/moSee all compatible tools
STDIO (via mcp-remote bridge)46 WHMCS Tools$22/month