Ictcrm Mcp

io.github.ictinnovationsPublished by GitHub account ictinnovationsv0.1.1Updated Oct 26, 2026

Read CRM contact groups and manage contacts on ICTCRM (ICTContact backend).

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

MCP server for ICTCRM that lets an assistant list CRM contact groups and, when writes are enabled, create or delete contacts and add them to campaigns.

What you can do
  • List contact groups in the CRM with their id, name and description
  • Create a contact in a group and get back the contact id (write mode only)
  • Delete a contact by id (write mode only)
  • Create a contact and attach it to a campaign (write mode only)
When to use it
Useful when you work with an ICTCRM (ICTContact backend) instance and want an assistant to look up contact groups or, deliberately, add or remove contacts and attach them to campaigns. Listing individual contacts is not available because the backend's list method fails.
Requirements
Runs locally via npx or a global npm install and needs Node.js 18 or newer. Requires the ICTCRM_BASE_URL, ICTCRM_USERNAME and ICTCRM_PASSWORD environment variables for an API account, plus network access to that server. Optional: ICTCRM_MCP_ALLOW_WRITE, ICTCRM_TIMEOUT_MS (default 30000) and ICTCRM_TLS_INSECURE.
Before you install
The account password is passed as ICTCRM_PASSWORD and sent with every RPC call, so use a dedicated API account. Write tools are off by default; setting ICTCRM_MCP_ALLOW_WRITE=true exposes creating and deleting contacts and adding contacts to campaigns, which changes CRM data. ICTCRM_TLS_INSECURE disables certificate checks and should only be used with a self-signed test server.

Installation

In SourceWeft

  1. Open Ictcrm Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ictcrm-mcp

A Model Context Protocol server for ICTCRM from ICT Innovations.

ictcrm.com runs on the ICTContact backend, so this server speaks that RPC surface. It lets an AI assistant read contact groups and — only when you turn writes on — create and delete contacts and add a contact to a campaign.

Install

bash
npx -y ictcrm-mcp      # no installnpm install -g ictcrm-mcp

Requires Node.js 18 or newer.

Configure

VariableRequiredDefault
ICTCRM_BASE_URLyesServer base URL, without the /rest suffix, e.g. https://your-ictcrm
ICTCRM_USERNAMEyesAPI account username
ICTCRM_PASSWORDyesPassword for that account
ICTCRM_MCP_ALLOW_WRITEnofalseUnlock the contact write tools (see Safety)
ICTCRM_TIMEOUT_MSno30000Per-request timeout
ICTCRM_TLS_INSECUREnofalseSkip 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:

ToolWhat it does
ictcrm_list_contact_groupsList contact groups (id, name, description)

Write tools appear only when ICTCRM_MCP_ALLOW_WRITE=true:

ToolWhat it does
ictcrm_create_contactCreate a contact in a group; returns the contact id
ictcrm_delete_contactDelete a contact by id
ictcrm_add_contact_to_campaignCreate a contact and attach it to a campaign

Safety

The server is read-only by default. Creating and deleting contacts only becomes possible when you set ICTCRM_MCP_ALLOW_WRITE=true.

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.

How it connects

Calls go to a form-encoded RPC API at {base}/rest/<Method>, each carrying the account username and password. There is no separate token to provision.

About

Built by Tahir Almas at ICT Innovations — the team behind ICTCRM, ICTContact, ICTDialer, ICTBroadcast, ICTFax and ICTPBX. Learn more at ictcrm.com.

MIT licensed. Issues and PRs welcome at github.com/ictinnovations/ictcrm-mcp.

Source: README.md at commit 48376ea

Tools

1

ictcrm_list_contact_groups

List contact groups

List the contact groups (contact lists) in the CRM, each with its id, name and description. Use a group id when creating a contact.

Takes no parameters.

Version history

2
  1. v0.1.1LatestOct 26, 2026
  2. v0.1.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts