kChat

You can run the kChat MCP Server to bridge your kChat workspace with an MCP client. It lets you list channels, post messages, reply in threads, react to posts, fetch histories, and manage user profiles through a consistent MCP interface.

How to use

When you run the kChat MCP Server, you expose a set of endpoints that your MCP client can call to interact with your kChat workspace. You can list channels, post messages to a channel, reply to threads, add reactions, fetch channel histories and thread replies, and manage user profiles and direct messages. Use the MCP client you prefer to issue the available tool commands against the server, providing the required inputs described in each tool.

How to install

Prerequisites: ensure you have a compatible runtime environment (Node.js/npm or Docker) available on the machine where you want to run the MCP server.

Choose one of the following runtime methods to start the MCP server.

Option 1: Run with NPX using a local or remote MCP server image via npx

{
  "mcpServers": {
    "kchat": {
      "command": "npx",
      "args": [
        "-y",
        "@infomaniak/mcp-server-kchat"
      ],
      "env": {
        "KCHAT_TOKEN": "your-token",
        "KCHAT_TEAM_NAME": "your-team"
      }
    }
  }
}

Option 2: Run with Docker using the MCP server image

{
  "mcpServers": {
    "kchat": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KCHAT_TOKEN",
        "-e",
        "KCHAT_TEAM_NAME",
        "infomaniak/mcp-server-kchat"
      ],
      "env": {
        "KCHAT_TOKEN": "your-token",
        "KCHAT_TEAM_NAME": "your-team"
      }
    }
  }
}

Available tools

list_channels

List public channels with optional limit and page parameters to control pagination and count.

post_message

Post a new message to a specified channel, requiring channel_id and text.

reply_to_thread

Reply to a specific message thread within a channel, requiring channel_id, thread_id, and text.

add_reaction

Add an emoji reaction to a specific post using the post_id and reaction name without colons.

get_channel_history

Fetch recent messages from a channel, with an optional limit for how many messages to retrieve.

get_thread_replies

Retrieve all replies in a given message thread identified by thread_id.

get_users

Get a list of workspace users with basic profiles, supporting pagination via limit and page.

get_user_profile

Retrieve detailed profile information for a specific user by user_id.

send_direct_message

Send a direct message to a user identified by username with the desired text.