MCP server for MAX messenger
mcp-max-messenger
MCP server for MAX messenger Bot API: messages, media, chats, participants and buttons from an agent
- 11 ★ on the repository
- Last commit
Extended access
Why this level
- Requires MAX bot token
- Tools send and delete messages, modify chat participants and admins
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mcp-max-messengerDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Requires MAX bot token
- Tools send and delete messages, modify chat participants and admins
This is third-party code. Review the repository files before installing.
What it does
Connects an agent to a bot in the MAX messenger via Bot API. Provides 21 tools: sending, reading, editing and pinning messages, sending photos, videos and files, managing chats and participants, receiving events and responding to button presses. Works locally via stdio or as an HTTP server.
Who it is for. For developers and teams automating notifications, approvals and chat management in MAX.
Good fit when
- Send notifications to MAX work chats from an agent or n8n
- Collect approvals with “Approve” and “Reject” buttons
- Read recent chat messages or new bot events
- Manage participants and admins in group chats
Not a fit when
- Access to a user’s personal account is required, not a bot
- Real-time webhooks are needed: currently events are received via long polling
Example request
Send an approval request for an invoice to the commands chat with “Approve” and “Reject” buttonsMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
MAX_TOKENrequired, secret- MAX bot token
MCP_TRANSPORT- Transport: stdio (default) or http
MCP_PORT- Port for HTTP mode, default 3000
Limitations
Operates on behalf of the bot, get_chats returns only group chats. MAX API has known issues: remove_admin may return success without removing rights, open_app button does not work, add_members fails with user privacy mode. Limit of 30 requests per second. MIT license with Commons Clause addition.
How to disable. Remove the max-messenger block from mcpServers in the client config. Revoke the bot token in MAX if needed.
FAQ
How to access personal dialogs with the bot?
Via get_updates: it returns chat_id, which is then used with other tools.
Is the Bearer prefix needed for the token?
No, MAX API accepts the token in the Authorization header without the Bearer prefix.
Discussion
No questions or reviews yet.
Related
All MAX messenger toolsMax Bot MCP server
Max Bot MCP Server
An MCP server that reads a bot's messages in the Max messenger: chats, members, text search and attachment downloads
MAX messenger MCP server
mcp-server-max
An MCP server for the MAX messenger (formerly VK Teams): sending and reading messages, chat management, pinning and typing status
MAX MCP
max-mcp
Local MCP server for MAX messenger using a user session: chats, search, channel export, sending messages and files
MAX AI secretary guide
clawbot-max-guide
A set of simplified Python examples for assembling a personal AI secretary in the MAX messenger via the Bot API, User API and MCP
MAX plugin for OpenClaw
openclaw-max-plus
A channel plugin that connects the OpenClaw AI assistant to the MAX messenger via the official Bot API: text, media, buttons, streaming, multiple accounts
Hosted MaxStat MCP server for searching and analyzing channels and posts in the MAX messenger
README in short
The server covers MAX Bot API with 21 tools for group messages, media, chats, participants and events, supporting five button types. It offers a stdio mode for Claude Desktop and Cursor and an HTTP mode for remote use. The README describes environment variables, architecture, MAX API specifics and known platform bugs. Planned features include hosting by URL and webhook support.