@instantkom/

GitHub Actions

Model Context Protocol Server for the instantKOM REST API. Lets Claude Code, Claude Desktop and other MCP-compatible AI assistants drive your instantKOM messengerzentrale.

Devops Developer Tools

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "instantkom-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@instantkom/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @instantkom/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add instantkom-mcp-server -- npx -y @instantkom/mcp-server@3.201.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "instantkom-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@instantkom/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 3.201.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @instantkom/?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @instantkom/ need an API key?

No required environment variable is listed on this record.

What transport does @instantkom/ use?

@instantkom/ runs locally over stdio.

When was @instantkom/ last checked?

Last checked 2026-10-28. Model Context Protocol Server for the instantKOM REST API. Lets Claude Code, Claude Desktop and other MCP-compatible AI assistants drive your instantKOM messengerzentrale.

From the publisher

Documentation

instantKOM 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.app by 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/

GitHub Actions

Model Context Protocol Server for the instantKOM REST API. Lets Claude Code, Claude Desktop and other MCP-compatible AI assistants drive your instantKOM messengerzentrale.

Devops Developer Tools

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "instantkom-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@instantkom/[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @instantkom/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add instantkom-mcp-server -- npx -y @instantkom/mcp-server@3.201.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "instantkom-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@instantkom/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 3.201.0
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install @instantkom/?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @instantkom/ need an API key?

No required environment variable is listed on this record.

What transport does @instantkom/ use?

@instantkom/ runs locally over stdio.

When was @instantkom/ last checked?

Last checked 2026-10-28. Model Context Protocol Server for the instantKOM REST API. Lets Claude Code, Claude Desktop and other MCP-compatible AI assistants drive your instantKOM messengerzentrale.

From the publisher

Documentation

instantKOM MCP-Server

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.app by 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.