# 3CX MCP

> 3CX MCP is an open-source MCP server for communication. Fleet health for 3CX phone systems: trunks, licences, versions and backups. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/servosity/msp-skills/tree/HEAD/skills/threecx
- **MCP Registry name:** io.github.Servosity/threecx-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

Built for providers who run many customers' 3CX systems, this connector surfaces health across the whole fleet and exposes the full Configuration API on any single PBX. Example commands in the README include listing offline SIP trunks, licences or maintenance expiring within 60 days, and PBXes behind the newest build.

It is unofficial and unaffiliated with 3CX Ltd. Authentication uses a client ID, client secret and the PBX host name. For ChatGPT or Microsoft 365 Copilot Studio you host it over HTTPS with a bearer token set; Gemini CLI and Claude Code use the local binary.

## Features

- **Fleet health overview:** Shows which client systems are failing or warning.
- **Trunk checks:** Finds SIP trunks that are offline or misconfigured.
- **Licence expiry:** Lists licences and maintenance due within a window.
- **Version gaps:** Identifies PBXes behind the latest build.
- **Config API access:** Full Configuration API for a single PBX.

## Good for

- Review all clients' phone systems each morning
- Plan licence renewals 60 days ahead
- Find PBXes needing updates
- Diagnose a customer's trunk outage

## Install

### Claude Code (Terminal)

```sh
claude mcp add threecx-mcp --env THREECX_CLIENT_ID='<THREECX_CLIENT_ID>' --env THREECX_CLIENT_SECRET='<THREECX_CLIENT_SECRET>' --env THREECX_FQDN='<THREECX_FQDN>' --env THREECX_MCP_HTTP_TOKEN='<THREECX_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/threecx-v0.1.5/threecx-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "threecx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/threecx-v0.1.5/threecx-mcp.mcpb"
      ],
      "env": {
        "THREECX_CLIENT_ID": "<THREECX_CLIENT_ID>",
        "THREECX_CLIENT_SECRET": "<THREECX_CLIENT_SECRET>",
        "THREECX_FQDN": "<THREECX_FQDN>",
        "THREECX_MCP_HTTP_TOKEN": "<THREECX_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "threecx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/threecx-v0.1.5/threecx-mcp.mcpb"
      ],
      "env": {
        "THREECX_CLIENT_ID": "<THREECX_CLIENT_ID>",
        "THREECX_CLIENT_SECRET": "<THREECX_CLIENT_SECRET>",
        "THREECX_FQDN": "<THREECX_FQDN>",
        "THREECX_MCP_HTTP_TOKEN": "<THREECX_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "threecx-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/threecx-v0.1.5/threecx-mcp.mcpb"
      ],
      "env": {
        "THREECX_CLIENT_ID": "<THREECX_CLIENT_ID>",
        "THREECX_CLIENT_SECRET": "<THREECX_CLIENT_SECRET>",
        "THREECX_FQDN": "<THREECX_FQDN>",
        "THREECX_MCP_HTTP_TOKEN": "<THREECX_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "threecx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/threecx-v0.1.5/threecx-mcp.mcpb"
      ],
      "env": {
        "THREECX_CLIENT_ID": "<THREECX_CLIENT_ID>",
        "THREECX_CLIENT_SECRET": "<THREECX_CLIENT_SECRET>",
        "THREECX_FQDN": "<THREECX_FQDN>",
        "THREECX_MCP_HTTP_TOKEN": "<THREECX_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "threecx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/threecx-v0.1.5/threecx-mcp.mcpb"
      ],
      "env": {
        "THREECX_CLIENT_ID": "<THREECX_CLIENT_ID>",
        "THREECX_CLIENT_SECRET": "<THREECX_CLIENT_SECRET>",
        "THREECX_FQDN": "<THREECX_FQDN>",
        "THREECX_MCP_HTTP_TOKEN": "<THREECX_MCP_HTTP_TOKEN>"
      }
    }
  }
}
```

## FAQ

### How do I connect it to ChatGPT?

Run it with the HTTP transport, an HTTPS host and a token, then add it as a Developer Mode connector.

### Is it from 3CX?

No, it is community-built.

### What credentials are needed?

THREECX_CLIENT_ID, THREECX_CLIENT_SECRET and THREECX_FQDN.

### Is 3CX MCP free?

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

### How do I add 3CX MCP to Claude Code?

Run this command in your terminal: claude mcp add threecx-mcp --env THREECX_CLIENT_ID='<THREECX_CLIENT_ID>' --env THREECX_CLIENT_SECRET='<THREECX_CLIENT_SECRET>' --env THREECX_FQDN='<THREECX_FQDN>' --env THREECX_MCP_HTTP_TOKEN='<THREECX_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/threecx-v0.1.5/threecx-mcp.mcpb

### What are the best alternatives to 3CX MCP?

The closest alternatives to 3CX MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/3cx-mcp
