mcp-server-max

A Model Context Protocol (MCP) server for Max messenger (formerly VK Teams / ICQ).

Lets any MCP-compatible AI assistant (Claude, OpenClaw, etc.) send and read messages, manage chats, and interact with the Max platform API.

Features

Installation

pip install mcp-server-max

Or with uv:

uvx mcp-server-max

Configuration

Getting a bot token

1. Open Max messenger
2. Find @MasterBot (or go to Chat-bots section)
3. Create a new bot and copy the token

Environment variables

Usage

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "max": {
      "command": "mcp-server-max",
      "env": {
        "MAX_BOT_TOKEN": "your-bot-token"
      }
    }
  }
}

Claude Code

{
  "mcpServers": {
    "max": {
      "command": "mcp-server-max",
      "env": {
        "MAX_BOT_TOKEN": "your-bot-token"
      }
    }
  }
}

OpenClaw

Add to openclaw.json:

{
  "mcp": {
    "servers": {
      "max": {
        "command": "mcp-server-max",
        "env": {
          "MAX_BOT_TOKEN": "your-bot-token"
        }
      }
    }
  }
}

Direct (stdio)

export MAX_BOT_TOKEN=your-bot-token
mcp-server-max

Examples

Once connected, your AI assistant can:

• Read messages: "What are the latest messages in the team chat?"
• Send messages: "Send 'Meeting at 3pm' to the project chat"
• Manage chats: "Who are the members of the dev chat?"
• Pin messages: "Pin the last important message"

API

This server uses the Max Bot API (https://platform-api.max.ru).

Requirements

• Python 3.10+
• A Max bot token (from @MasterBot)

License

MIT

Links

• Model Context Protocol
• Max Bot API Docs
• Max Messenger