# Ictpbx MCP

> Ictpbx MCP is an open-source MCP server for communication. Read ICTPBX extensions, DIDs, SIP trunks, tenants and live statistics. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://ictpbx.com
- **Repository:** https://github.com/ictinnovations/ictpbx-mcp
- **MCP Registry name:** io.github.ictinnovations/ictpbx-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

What it reads is limited to the ICTPBX state exposed through the ICTCore REST API, and it is read-only: it never places a call or changes configuration. ICTPBX itself is an open-source, multi-tenant, white-label PBX built on FreeSWITCH for service providers.

The server logs in by email with an API account, fetches a JWT on first use and refreshes it automatically. Five tools return PBX counts, SIP extensions, DID numbers, SIP trunk providers and tenants. Configuration needs the ICTCore base URL, normally ending in /api, a username and a password; a TLS-insecure option exists for self-signed test servers only.

It installs with npx and needs Node 18 or newer. ICT Innovations, the maker of ICTPBX, publishes it under the MIT licence. ICTPBX runs as a monthly cloud subscription or self-hosted, with a free Community Edition.

## Features

- **Statistics:** Counts of extensions, devices, queues, IVRs, voicemails, conferences and gateways.
- **Extensions:** Lists SIP extensions with username, name and tenant.
- **DID numbers:** Shows inbound numbers, state and tenant.
- **SIP providers:** Lists upstream trunk carriers.
- **Tenants:** Lists customer organizations on the PBX.
- **Auto token refresh:** Handles JWT login and renewal.

## Good for

- Ask how many extensions each tenant has
- Audit DID assignments
- List configured trunk providers
- Summarise PBX size for a report

## Install

### Claude Code (Terminal)

```sh
claude mcp add ictpbx-mcp --env ICTPBX_BASE_URL='<ICTPBX_BASE_URL>' --env ICTPBX_USERNAME='<ICTPBX_USERNAME>' --env ICTPBX_PASSWORD='<ICTPBX_PASSWORD>' -- npx -y ictpbx-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ictpbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictpbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "ictpbx-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictpbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictpbx-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictpbx-mcp"
      ],
      "env": {
        "ICTPBX_BASE_URL": "<ICTPBX_BASE_URL>",
        "ICTPBX_USERNAME": "<ICTPBX_USERNAME>",
        "ICTPBX_PASSWORD": "<ICTPBX_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `ictpbx_pbx_statistics`: Counts of extensions, devices, ring groups, queues, IVRs, voicemails, conferences and gateways.
- `ictpbx_list_extensions`: SIP extensions with username, name and tenant.
- `ictpbx_list_dids`: DID numbers with active state and tenant.
- `ictpbx_list_providers`: SIP trunk providers.
- `ictpbx_list_tenants`: Tenants on the PBX.

## FAQ

### Can it change my PBX?

No, it is read-only.

### What does it need to connect?

ICTPBX_BASE_URL, an account email and a password.

### Which Node version?

18 or newer.

### Is ICTPBX free?

A Community Edition is free to self-host; cloud plans start at $990 a year for Launch.

### Is Ictpbx MCP free?

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

### How do I add Ictpbx MCP to Claude Code?

Run this command in your terminal: claude mcp add ictpbx-mcp --env ICTPBX_BASE_URL='<ICTPBX_BASE_URL>' --env ICTPBX_USERNAME='<ICTPBX_USERNAME>' --env ICTPBX_PASSWORD='<ICTPBX_PASSWORD>' -- npx -y ictpbx-mcp

### What are the best alternatives to Ictpbx MCP?

The closest alternatives to Ictpbx 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/ictpbx-mcp
