ICTCRM MCP Server (io.github.ictinnovations/ictcrm-mcp)

This Model Context Protocol (MCP) server provides access to ICTCRM (ICTContact backend) for reading CRM contact groups and managing contacts. It exposes an RPC surface compatible with ictcrm.com, and supports contact creation and deletion, plus adding contacts to campaigns when writes are enabled.

🛠️ Key Features

Read CRM contact groups
Manage contacts on ICTCRM (ICTContact backend)
Create and delete contacts (only when writes are turned on)
Add a contact to a campaign (only when writes are turned on)
MCP server: “ictcrm-mcp”

🚀 Use Cases

Let an AI assistant retrieve contact group information from ICTCRM
Automate contact updates (create/delete) when write access is enabled
Add contacts to campaigns via ICTCRM backend operations

⚡ Developer Benefits

Model Context Protocol integration for structured CRM access
Speaks the ICTContact RPC surface used by ictcrm.com
Package availability via npx (no install) or global npm install

⚠️ Limitations

Write operations (create/delete contacts, add to campaign) require writes to be enabled
Requires Node.js 18 or newer

Configure

Variable

Required

Default

ICTCRM_BASE_URL

yes

Server base URL, without the /rest suffix, e.g. https://your-ictcrm

ICTCRM_USERNAME

yes

API account username

ICTCRM_PASSWORD

yes

Password for that account

ICTCRM_MCP_ALLOW_WRITE

false

Unlock the contact write tools (see Safety)

ICTCRM_TIMEOUT_MS

30000

Per-request timeout

ICTCRM_TLS_INSECURE

false

Skip TLS verification — self-signed test servers only

Claude Desktop example

json

{
  "mcpServers": {
    "ictcrm": {
      "command": "npx",
      "args": ["-y", "ictcrm-mcp"],
      "env": {
        "ICTCRM_BASE_URL": "https://your-ictcrm",
        "ICTCRM_USERNAME": "admin",
        "ICTCRM_PASSWORD": "your-password"
      }
    }
  }
}

Tools

Read tools are always available:

Tool

What it does

ictcrm_list_contact_groups

List contact groups (id, name, description)

Write tools appear only when ICTCRM_MCP_ALLOW_WRITE=true:

Tool

What it does

ictcrm_create_contact

Create a contact in a group; returns the contact id

ictcrm_delete_contact

Delete a contact by id

ictcrm_add_contact_to_campaign

Create a contact and attach it to a campaign

A note on listing contacts

The ICTContact backend that ICTCRM runs on exposes contact groups and contact creation/deletion, but its "list contacts" method errors server-side, so this server does not offer a contact-listing tool. It manages contacts and reads contact groups; listing individual contacts is not available over the API today.

Install

Configuration

Environment variables

ICTCRM_BASE_URLrequired

Base URL of your ICTCRM server, without the /rest suffix, e.g. https://your-ictcontact.

ICTCRM_USERNAMErequired

API account username.

ICTCRM_PASSWORDrequiredsecret

Password for the account.

ICTCRM_MCP_ALLOW_WRITEdefault false

Unlocks starting and stopping campaigns, which begins live outbound calling and can cost money. When false those tools are not registered at all. Leave off unless you mean it.

ICTCRM_TIMEOUT_MSdefault 30000

Per request timeout in milliseconds. Defaults to 30000.

ICTCRM_TLS_INSECUREdefault false

Skip TLS certificate verification. Only for a self-signed test server.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ictcrm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ictcrm-mcp@0.1.0"
      ],
      "env": {
        "ICTCRM_BASE_URL": "<YOUR_ICTCRM_BASE_URL>",
        "ICTCRM_USERNAME": "<YOUR_ICTCRM_USERNAME>",
        "ICTCRM_PASSWORD": "<YOUR_ICTCRM_PASSWORD>",
        "ICTCRM_MCP_ALLOW_WRITE": "false",
        "ICTCRM_TIMEOUT_MS": "30000",
        "ICTCRM_TLS_INSECURE": "false"
      }
    }
  }
}

io.github.ictinnovations/ictcrm-mcp

ICTCRM MCP Server (io.github.ictinnovations/ictcrm-mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

ictcrm-mcp

Install

Configure

Claude Desktop example

Tools

Safety

A note on listing contacts

How it connects

About

Install

Configuration

Related servers