Max Messenger MCP server
MCP server for MAX Messenger by VK. 21 tools: messages, media, buttons, members, events.
10 stars
Reviews
Write oneNobody has reviewed Max Messenger yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Max Messenger tools (21, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_membersAdd one or more users to a group chat.
answer_callbackRespond to an inline button click (callback event from get_updates).
delete_messagewrite actionDelete a message sent by the bot. Requires the message_id.
edit_chatRename a chat, change its description, or update its icon.
edit_messageEdit the text of an existing message sent by the bot.
get_adminsGet the list of administrators in a group chat.
get_bot_infoGet information about the MAX bot: name, username, user_id, description.
get_chatGet full details of a specific chat by its ID: title, description,
get_chat_membersGet the list of participants in a group chat. Returns user_id, name, username for each member.
get_chatsGet the list of all group chats where the bot is a participant.
get_messageGet a single message by its ID. Returns full message details including text, sender, attachments.
get_messagesRead messages from a MAX chat. Use either chat_id OR message_ids — they are mutually exclusive.
get_updatesGet incoming events: new messages, button clicks, user joins/leaves, etc.
pin_messagePin a message in a group chat. The bot must have admin rights in the chat.
remove_adminwrite actionRevoke admin rights from a chat member. They remain a regular member.
remove_memberwrite actionRemove a user from a group chat.
send_actionwrite actionShow a typing indicator or other status to chat members.
send_mediawrite actionUpload a file (image/video/audio/file) from a URL and send it as a message.
send_messagewrite actionSend a text message to a MAX chat or user.
set_adminGrant admin rights to a chat member.
unpin_messageUnpin the currently pinned message in a group chat. The bot must have admin rights.
Public scan report
scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan24 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 180 days ago4/15
- Maintainer identityregistry namespace matches repository owner6/10
How Max Messenger compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 63/100
- higher than 18% of 48,255 servers
- Tools
- 21
- the typical server has 7
- Tools that change things
- 29%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 10
- more than 88% of 28,688 servers
What its tools let an agent do: 11 read · 1 create · 3 change · 3 delete · 3 send or post
Install Max Messenger in Claude Code, Cursor or VS Code
Runs npx -y @woyax/mcp-max-messenger on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add max-messenger -- npx -y @woyax/mcp-max-messenger
What the publisher says
From the Max Messenger repository's README, as published. We do not edit it. Read it on GitHub
mcp-max-messenger
The first MCP server for MAX Messenger — Russia's national messenger by VK (75M+ users).
Connect AI clients (Claude Desktop, Cursor, n8n, and any MCP-compatible app) to MAX: send and read messages, manage chats and members, send media, handle button presses, format with HTML/Markdown — all through the open Model Context Protocol standard.
21 tools with full coverage of MAX Bot API.
Why MAX?
- 🇷🇺 National messenger mandated for pre-installation on all smartphones in Russia (September 2025)
- 📱 75M+ registered users
- 🏢 Recommended by the Ministry of Digital Development for government agencies and large enterprises
- 🤖 Full Bot API with official SDKs: TypeScript, Python, Go, Java, PHP
Quick Start
Prerequisites
- Node.js 18+
- A MAX bot token (create a bot at max.ru)
Claude Desktop / Cursor (stdio mode)
Add to your Claude Desktop config:
Mac: ~/Library/Application Support/Claude/claudedesktopconfig.json Windows: %APPDATA%\Claude\claudedesktopconfig.json
{
"mcpServers": {
"max-messenger": {
"command": "npx",
"args": ["-y", "@woyax/mcp-max-messenger"],
"env": {
"MAX_TOKEN": "YOUR_BOT_TOKEN"
}
}
}
}Restart Claude Desktop. The MAX tools will appear automatically.
Remote / Hosted mode (HTTP)
MAX_TOKEN=YOUR_BOT_TOKEN MCP_TRANSPORT=http MCP_PORT=3000 npx @woyax/mcp-max-messengerConnect any MCP client to http://your-server:3000/mcp.
Available Tools (21)
Messages
Media
Chats
Members
Events
Buttons (via send_message attachments)
5 button types supported: callback, link, message, requestcontact, requestgeo_location.
Usage Examples
Once connected to Claude Desktop, use natural language:
"Send a message to chat 123456789: 'The meeting starts in 10 minutes'"
"Send an approval request with Approve/Reject buttons to the team chat"
"Show me the last 10 messages from the announcements chat"
"Send this photo to the chat: https://example.com/image.jpg"
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Max Messenger: common questions
- Is Max Messenger MCP server safe?
- With care: it is graded C, so read the findings first (63/100). Read the Max Messenger safety report
- How do I install Max Messenger?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Max Messenger need an API key?
- Yes. The registry entry asks for
MAX_TOKEN. - Is Max Messenger maintained?
- The last commit was 218 days ago (2026-03-31). The latest release is v1.2.2.
- How does Max Messenger compare with other MCP servers?
- safety score 63/100 (higher than 18% of 48,255 servers); tools 21 (the typical server has 7); tools that change things 29% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.