Skip to content
MCP server

Ictcrm MCP

Read ICTCRM contact groups and create or delete contacts, with writes off by default

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.1
Listing updated
2 days ago

About Ictcrm MCP

Ictcrm MCP is an open-source MCP server for sales and crm. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • ICTCRM_BASE_URLBase URL of your ICTCRM server, without the /rest suffix, e.g. https://your-ictcontact.Required
  • ICTCRM_USERNAMEAPI account username.Required
  • ICTCRM_PASSWORDPassword for the account.Required
  • ICTCRM_MCP_ALLOW_WRITEUnlocks 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_MSPer request timeout in milliseconds. Defaults to 30000.
  • ICTCRM_TLS_INSECURESkip TLS certificate verification. Only for a self-signed test server.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MCP server is MIT licensed; ICTCRM cloud plans and self-hosted licences are priced separately

Prices change. Check ictcrm.com before you buy.

Ictcrm MCP 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 to Ictcrm MCP

  1. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  2. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  3. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. ZUUZ

    MCP server

    Ask Claude or ChatGPT about deals and follow-ups ZUUZ finds in sales email for MSPs

    Not checked yet
    • Remote
    • Free trial
    • Sales and CRM
  6. Fuse

    MCP server

    Hosted MCP server for B2B prospecting, contact enrichment, buying signals and outreach

    Not checked yet
    • Remote
    • Freemium
    • Sales and CRM