kChat MCP Server

MCP Server for the kChat API.

Tools

1. kchat_list_channels

   • List public channels
   • Optional inputs:
     • limit (number, default: 100, max: 200): Maximum number of channels to return
     • page (number, default: 0): Pagination page
   • Returns: List of channels with their IDs and information

2. kchat_post_message

   • Post a new message to a kChat channel
   • Required inputs:
     • channel_id (string): The ID of the channel to post to
     • text (string): The message text to post
   • Returns: Message post

3. kchat_reply_to_thread

   • Reply to a specific message thread
   • Required inputs:
     • channel_id (string): The channel containing the thread
     • thread_id (string): The parent message ID
     • text (string): The reply text
   • Returns: Message post

4. kchat_add_reaction

   • Add an emoji reaction to a message
   • Required inputs:
     • post_id (string): The message ID
     • reaction (string): Emoji name without colons
   • Returns: Reaction

5. kchat_get_channel_history

   • Get recent messages from a channel
   • Required inputs:
     • channel_id (string): The channel ID
   • Optional inputs:
     • limit (number, default: 10): Number of messages to retrieve
   • Returns: List of messages with their content and metadata

6. kchat_get_thread_replies

   • Get all replies in a message thread
   • Required inputs:
     • thread_id (string): The parent message ID
   • Returns: List of replies with their content and metadata

7. kchat_get_users

   • Get list of workspace users with basic profile information
   • Optional inputs:
     • limit (number, default: 100, max: 100): Maximum number of users to return
     • page (number, default: 0): Pagination page
   • Returns: List of users with their basic profiles

8. kchat_get_user_profile

   • Get detailed profile information for a specific user
   • Required inputs:
     • user_id (string): The user's ID
   • Returns: Detailed user profile information

9. kchat_send_direct_message

   • Send a direct message to a user by username
   • Required inputs:
     • username (string): The username of the user to send the message to
     • text (string): The message text to send
   • Returns: Message post

Setup

1. Create a kChat token linked to your user:

   • Visit the API Token page
   • Choose "kChat" scope

   Create a kChat token linked to a bot:

   • Visit your kChat webapp and click on New > Integrations > Bot accounts > Add bot accounts

2. Get your kChat team name from your kChat url (eg. https://your-team.kchat.infomaniak.com/your-team/channels/town-square url have your-team team)

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

NPX

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

docker

{
  "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"
      }
    }
  }
}

Environment Variables

1. KCHAT_TOKEN: Required. Your kChat token.
2. KCHAT_TEAM_NAME: Required. Your kChat team unique name.

Troubleshooting

If you encounter permission errors, verify that:

1. All required scopes are added to your kChat token
2. The token and team name are correctly copied to your configuration

Build

Docker build:

docker build -t infomaniak/mcp-server-kchat -f Dockerfile .

License

This MCP server is licensed under the MIT License.