MAX Messenger MCP server

Install

{
  "mcpServers": {
    "max-messenger": {
      "command": "npx",
      "args": ["-y", "@woyax/mcp-max-messenger"],
      "env": {
        "MAX_TOKEN": "YOUR_BOT_TOKEN"
      }
    }
  }
}

This is third-party code. Review the repository files before installing.

What it does

Connects an agent to a MAX messenger bot via the Bot API. It offers 21 tools: sending, reading, editing and pinning messages, sending photos, video and files, managing chats and members, receiving events and answering button presses. It runs locally over stdio or as an HTTP server.

Who it is for. Developers and teams automating notifications, approvals and chat work in MAX.

Example request

Send an invoice approval request with Approve and Reject buttons to the team chat

Limitations

Acts as a bot, and get_chats returns group chats only. Known MAX API issues: remove_admin may report success without revoking rights, the open_app button fails, and add_members fails if the user has privacy mode on. Rate limit is 30 requests per second. License is MIT + Commons Clause.

How to disable. Remove the max-messenger block from mcpServers in the client config. Revoke the bot token in MAX if needed.

MCP

Transport

stdio, http

Authentication

API key

Security check

• Requires a MAX bot token
• Tools send and delete messages and change chat members and admins

README in short

The server covers the MAX Bot API with 21 tools across messages, media, chats, members and events, and supports five button types. It has stdio mode for Claude Desktop and Cursor and HTTP mode for remote use. The README documents environment variables, architecture, MAX API specifics and known platform bugs. Hosted URL access and webhook support are on the roadmap.

Related