instantKOM MCP server
Commit Oct 31, 2026Enables AI assistants to manage multi-channel messenger communications, including contacts, messages, newsletters, and automation flows.
Also known as instantKOM/mcp-server, @instantkom/mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 2,042
- Latest version
- —
- Last commit
- Oct 31, 2026
- License
- MIT
What is instantKOM MCP?
instantKOM enables AI assistants to manage multi-channel messenger communications, including contacts, messages, newsletters, and automation flows.
Summary generated from the project's README
About instantKOM MCP server
Managing multi-channel messenger communications through an AI assistant is what this server enables for marketing and customer communication teams. By connecting to the instantKOM REST API, users can direct Claude Desktop or Claude Code to handle complex tasks across platforms like WhatsApp, Telegram, and SMS. The server runs locally on your machine using Node.js and requires an instantKOM API key provided as a bearer token in your configuration.
This integration provides access to over 230 tools that cover the full lifecycle of messenger management. You can use specific tools to manage channels, contacts, and messages, or handle more complex automation through bots and flows. The toolset also includes capabilities for sending newsletters, managing segmentation, creating QR codes, and monitoring analytics via dashboard KPIs. Because the server runs locally, your data remains private and does not pass through third-party hosts during the process.
What you can do with it
- 1Distribute targeted newslettersAsk the AI to send a broadcast to a specific group of segmented contacts.
- 2Automate customer engagement flowsUse the assistant to manage and configure bot nodes and automation edges.
- 3Monitor communication performanceRequest a summary of key performance indicators for your messaging campaigns.
Written from the project's README. Every use case is checked against a quote from it.
How to install instantKOM MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall instantKOM MCP in Claude Code
$ claude mcp add mcp-server -- npx -y @instantkom/mcp-serverInstall instantKOM MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@instantkom/mcp-server"
]
}
}
}Install instantKOM MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@instantkom/mcp-server"
]
}
}
}Install instantKOM MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@instantkom/mcp-server"]}'Install instantKOM MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@instantkom/mcp-server"
]
}
}
}Install instantKOM MCP in Codex
$ codex mcp add mcp-server -- npx -y @instantkom/mcp-serverInstall instantKOM MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@instantkom/mcp-server"]
Install instantKOM MCP in Gemini CLI
$ gemini mcp add -s user mcp-server npx -- -y @instantkom/mcp-serverInstall instantKOM MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@instantkom/mcp-server"
]
}
}
}Configuration
INSTANTKOM_API_KEY
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableinstantkom/mcp-server is public and reachablegithub.com/instantkom/mcp-server ↗Pass
- Package names this repository as its source@instantkom/mcp-server names instantkom/mcp-server as sourcenpmjs.com/package/@instantkom/mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-31github.com/instantkom/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @instantkom/mcp-serverPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubinstantKOM MCP-Server
Model Context Protocol (MCP) server for the instantKOM REST API. Lets AI assistants like Claude Code and Claude Desktop drive your instantKOM messengerzentrale through structured, type-safe tool calls.
Features
- 230+ tools covering full CRUD for Channels, Contacts, Messages, Newsletters, Bots, Flows, Analytics and more
- Type-safe — written in TypeScript, runs on Node.js 18+
- Bearer-token auth via your instantKOM API key
- Standardized — implements the official Model Context Protocol
- MIT-licensed — self-hosted use is welcome
Quick start
1. Get an API key
- Sign up at instantkom.app
- Settings → API Keys → create a new key
- Copy the key (format:
ik_live_...)
2. Configure your MCP client
Add to your Claude Code / Claude Desktop config:
Claude Code: project-local .mcp.json or ~/.config/claude/claude_desktop_config.json
Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"instantkom": {
"command": "npx",
"args": ["-y", "@instantkom/mcp-server"],
"env": {
"INSTANTKOM_API_KEY": "ik_live_..."
}
}
}
}
3. Restart your client
Claude will now see the instantkom MCP server with all available tools.
Configuration
| Environment variable | Description | Default |
|---|---|---|
INSTANTKOM_API_KEY |
Bearer token for the instantKOM API (required) | — |
INSTANTKOM_API_URL |
Override API base URL | https://api.instantkom.app |
LOG_LEVEL |
error / warn / info / debug |
info |
Tool overview
Tools are grouped by resource type. Each REST endpoint at api.instantkom.app/api-docs has a corresponding MCP tool.
| Category | Examples | Tools |
|---|---|---|
| Channels | list_channels, create_channel, update_channel |
7 |
| Contacts | list_contacts, create_contact, update_contact |
5 |
| Messaging | send_message, list_messages, get_message |
10 |
| Newsletters / Broadcasts | list_broadcasts, create_broadcast, send_broadcast |
6 |
| Bots & Flows | bot CRUD, flow nodes, flow edges | 38 |
| Templates & Tags | template + tag CRUD, tag assignment | 21 |
| Analytics | dashboard, broadcast, contact, message KPIs | 5 |
| Segmentation & QR | segmentation CRUD, QR codes, shortlinks | 13 |
| Tickets / Webhooks / Polls / Events / Media / Custom Fields / ... | full CRUD | 100+ |
Examples
Once configured, you can prompt Claude in natural language:
> Send a newsletter to all "Premium" segment contacts.
⏺ I'll create the newsletter via WhatsApp.
⤷ create_broadcast(channel: "whatsapp", segment: "premium")
↳ 247 recipients · sending now.
⏺ Done. Sent to 247 Premium contacts. Show live analytics?
Development
git clone https://github.com/instantKOM/mcp-server.git
cd mcp-server
npm install
npm run build
INSTANTKOM_API_KEY=ik_live_... node dist/index.public.js
To wire up your local build with Claude Code instead of npm:
{
"mcpServers": {
"instantkom": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/dist/index.public.js"],
"env": {
"INSTANTKOM_API_KEY": "ik_live_..."
}
}
}
}
Security
- API keys are passed as Bearer tokens. Treat them as secrets.
- All API calls go over HTTPS to
api.instantkom.appby default. - The MCP server runs locally on your machine — no instantKOM data passes through any third-party host.
- Audit log of every tool call is recorded server-side in your instantKOM account.
Resources
- API Documentation: https://api.instantkom.app/api-docs
- MCP Protocol Spec: https://modelcontextprotocol.io
- API Code Examples: https://github.com/instantKOM/api-examples
- Issues / Feature Requests: https://github.com/instantKOM/mcp-server/issues
License
MIT — see LICENSE.
About instantKOM
instantKOM is a multi-channel messenger platform for B2B marketing and customer communication. WhatsApp, Telegram, Signal, Threema, SMS — DSGVO-compliant, hosted in Germany. Learn more at instantkom.app.
instantKOM MCP questions
How do I add instantKOM MCP to Claude Code?
Run claude mcp add mcp-server -- npx -y @instantkom/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add instantKOM MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I authenticate with the instantKOM MCP server?
You use Bearer-token authentication via your instantKOM API key, which follows the format ik_live_...
What kind of tools are available in this server?
The server provides over 230 tools covering CRUD operations for channels, contacts, messages, newsletters, bots, flows, and analytics.
Is my data secure when using this server?
Yes, the MCP server runs locally on your machine so no data passes through a third-party host, and all API calls use HTTPS.