# Ictcrm MCP

> Ictcrm MCP is an open-source MCP server for sales and crm. Read ICTCRM contact groups and create or delete contacts, with writes off by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://ictcrm.com
- **Repository:** https://github.com/ictinnovations/ictcrm-mcp
- **MCP Registry name:** io.github.ictinnovations/ictcrm-mcp
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-15

## About

The server is deliberately narrow. It talks to the ICTContact backend that ICTCRM runs on, over a form-encoded RPC at `{base}/rest/<Method>` with the account's username and password, and no separate token. One read tool lists contact groups. Three write tools, create contact, delete contact and create-and-add-to-campaign, are not even registered unless you set `ICTCRM_MCP_ALLOW_WRITE=true`.

The README notes a limit: the backend's "list contacts" method errors server-side, so there is no contact-listing tool. The registry entry also says the write flag guards starting and stopping campaigns, which begins live outbound calling and can cost money; the README itself lists contact tools under that flag, so check which tools your version registers.

ICTCRM is a CRM with a built-in contact center: auto dialer, campaigns, IVR, WebRTC calling and an AI voice agent, with a timeline of every call, text and email. It is open source under AGPL-3.0 and can be self-hosted, with cloud plans priced by concurrent channels and users. This MCP server is MIT licensed and runs with `npx -y ictcrm-mcp` on Node 18 or newer.

## Features

- **Contact group listing:** `ictcrm_list_contact_groups` returns id, name and description.
- **Write tools gated:** Create and delete tools only register with `ICTCRM_MCP_ALLOW_WRITE=true`.
- **Campaign enrollment:** Create a contact and attach it to a campaign in one call.
- **Simple credentials:** Base URL, username and password; no separate token.
- **Configurable timeout:** Per-request timeout defaults to 30,000 ms.
- **Self-signed test support:** `ICTCRM_TLS_INSECURE` skips TLS checks for test servers only.

## Good for

- See which contact groups exist in an ICTCRM account
- Add a new lead to a calling campaign from a chat
- Delete a test contact by id
- Load contacts into a group from another system

## Install

### Claude Code (Terminal)

```sh
claude mcp add ictcrm-mcp --env ICTCRM_BASE_URL='<ICTCRM_BASE_URL>' --env ICTCRM_USERNAME='<ICTCRM_USERNAME>' --env ICTCRM_PASSWORD='<ICTCRM_PASSWORD>' -- npx -y ictcrm-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ictcrm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcrm-mcp"
      ],
      "env": {
        "ICTCRM_BASE_URL": "<ICTCRM_BASE_URL>",
        "ICTCRM_USERNAME": "<ICTCRM_USERNAME>",
        "ICTCRM_PASSWORD": "<ICTCRM_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictcrm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcrm-mcp"
      ],
      "env": {
        "ICTCRM_BASE_URL": "<ICTCRM_BASE_URL>",
        "ICTCRM_USERNAME": "<ICTCRM_USERNAME>",
        "ICTCRM_PASSWORD": "<ICTCRM_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "ictcrm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ictcrm-mcp"
      ],
      "env": {
        "ICTCRM_BASE_URL": "<ICTCRM_BASE_URL>",
        "ICTCRM_USERNAME": "<ICTCRM_USERNAME>",
        "ICTCRM_PASSWORD": "<ICTCRM_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictcrm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcrm-mcp"
      ],
      "env": {
        "ICTCRM_BASE_URL": "<ICTCRM_BASE_URL>",
        "ICTCRM_USERNAME": "<ICTCRM_USERNAME>",
        "ICTCRM_PASSWORD": "<ICTCRM_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ictcrm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcrm-mcp"
      ],
      "env": {
        "ICTCRM_BASE_URL": "<ICTCRM_BASE_URL>",
        "ICTCRM_USERNAME": "<ICTCRM_USERNAME>",
        "ICTCRM_PASSWORD": "<ICTCRM_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `ictcrm_list_contact_groups`: Lists contact groups with id, name and description
- `ictcrm_create_contact`: Creates a contact in a group and returns its id
- `ictcrm_delete_contact`: Deletes a contact by id
- `ictcrm_add_contact_to_campaign`: Creates a contact and attaches it to a campaign

## FAQ

### Is it read-only?

By default yes; the write tools only appear with `ICTCRM_MCP_ALLOW_WRITE=true`.

### Can it list contacts?

No. The README says the backend's list-contacts method errors, so only groups can be listed.

### What does it need to connect?

`ICTCRM_BASE_URL`, `ICTCRM_USERNAME` and `ICTCRM_PASSWORD`.

### What Node version?

Node.js 18 or newer.

### Is ICTCRM free?

The code is open source under AGPL-3.0; cloud plans and licences are priced separately.

### Is Ictcrm MCP free?

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

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

Run this command in your terminal: claude mcp add ictcrm-mcp --env ICTCRM_BASE_URL='<ICTCRM_BASE_URL>' --env ICTCRM_USERNAME='<ICTCRM_USERNAME>' --env ICTCRM_PASSWORD='<ICTCRM_PASSWORD>' -- npx -y ictcrm-mcp

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

The closest alternatives to Ictcrm MCP are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/ictcrm-mcp
