Ictcrm MCP Server

by ictinnovationsio.github.ictinnovations/ictcrm-mcpv0.1.0

ICTCRM, an open-source CRM with built-in telephony: read contact groups, with opt-in tools to create and delete contacts and add them to calling campaigns.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained32d ago

Install Ictcrm MCP server

claude mcp add ictcrm -e ICTCRM_BASE_URL='<ictcrm-base-url>' -e ICTCRM_USERNAME='<ictcrm-username>' -e ICTCRM_PASSWORD='<ictcrm-password>' -- npx -y ictcrm-mcp

{
  "mcpServers": {
    "ictcrm": {
      "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 (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ictcrm": {
      "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ictcrm": {
      "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.

Configuration

Variable	Required	Secret	Description
ICTCRM_BASE_URL	yes	—	Base URL of your ICTCRM server, without the /rest suffix, e.g. https://your-ictcontact.
ICTCRM_USERNAME	yes	—	API account username.
ICTCRM_PASSWORD	yes	yes	Password for the account.
ICTCRM_MCP_ALLOW_WRITE	—	—	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_MS	—	—	Per request timeout in milliseconds. Defaults to 30000.
ICTCRM_TLS_INSECURE	—	—	Skip TLS certificate verification. Only for a self-signed test server.

Freshness

Maintained — last maintenance signal 32d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-07 · 32d ago · GitHub
Latest release
2026-09-01 · 39d ago · GitHub · v0.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-01 · 39d ago · official registry · v0.1.0

FAQ

›How do I install the Ictcrm MCP server in Claude Code?

Run: claude mcp add ictcrm -e ICTCRM_BASE_URL='<ictcrm-base-url>' -e ICTCRM_USERNAME='<ictcrm-username>' -e ICTCRM_PASSWORD='<ictcrm-password>' -- npx -y ictcrm-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ictcrm require an API key?

Yes. It expects ICTCRM_BASE_URL, ICTCRM_USERNAME, ICTCRM_PASSWORD, of which 1 is a secret.

›Can I use Ictcrm as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Ictcrm in the official MCP registry?

Yes, as io.github.ictinnovations/ictcrm-mcp.