Claude Desktop + WHMCS MCP Server
Claude Desktop connects to WHMCS through local STDIO transport. It reads a JSON config file on your machine, spawns the MCP bridge process, and gives you access to 45 WHMCS tools. No public URL required. Works on free, Pro, Team, and Enterprise plans.
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.
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
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
Restart and test
Restart Claude Desktop and try a simple query like “Get WHMCS system status” to verify the connection.
Example Prompts
Real queries you can ask Claude Desktop once connected to WHMCS.
“How many active clients do we have? Show monthly growth for the last 6 months.”
“List all overdue invoices over $500. Include client name and days overdue.”
“Get the support ticket history for client domain hostingpro.com.”
“Show our top 10 clients by revenue this quarter.”
“What products have the highest churn rate this month?”
“Create a support ticket for client #1042 about their scheduled server migration next week.”
“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.
| Feature | Claude Desktop | ChatGPT | Cursor |
|---|---|---|---|
| MCP Transport | STDIO (local) | Remote HTTP only | STDIO + SSE |
| Localhost support | Yes | No (public URL needed) | Yes |
| Free tier MCP | Yes | No (Plus $20/mo) | Community tier |
| MCP maturity | Stable since Mar 2024 | Beta since Sep 2025 | Stable since mid 2024 |
| Max tool calls/turn | 5 | 3 (beta limit) | Varies by model |
| Config method | JSON file | Settings UI | JSON file |
| Conversation export | No native export | Share links | IDE 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.
MCP Server
AI Integration Hub
Better Together
MCP Server works with the full MX ecosystem. More modules, more data, more capabilities.
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 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 45 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.