Max Messenger
Connects Claude to MAX Messenger, Russia's national messenger with 75M+ users and government mandate for smartphone pre-installation. Exposes 21 tools covering the full MAX Bot API: send and read messages with HTML/Markdown formatting, upload media (photo, video, audio, files), manage group chats and members, set admin permissions, create inline button keyboards (callback, link, message, contact/location requests), and poll for incoming events. Built for both local use via stdio (Claude Desktop, Cursor) and remote HTTP deployments. Useful if you're building AI workflows that need to interact with MAX chats, whether for customer support automation, team notifications, or bot-driven group management in the Russian market.
- GitHub stars
- 3
- tools
- 20
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 24, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
get_messagesRead messages from a chat (by chat_id or message_ids)
Read messages from a chat (by chat_id or message_ids)
No parameter schema in public metadata yet.
send_messageSend a message with text, HTML/Markdown, inline keyboard, media attachments
Send a message with text, HTML/Markdown, inline keyboard, media attachments
No parameter schema in public metadata yet.
edit_messageEdit message text and attachments
Edit message text and attachments
No parameter schema in public metadata yet.
delete_messageDelete a message
Delete a message
No parameter schema in public metadata yet.
pin_messagePin a message in a chat
Pin a message in a chat
No parameter schema in public metadata yet.
unpin_messageUnpin the currently pinned message
Unpin the currently pinned message
No parameter schema in public metadata yet.
send_mediaUpload and send photo, video, audio, or file by URL
Upload and send photo, video, audio, or file by URL
No parameter schema in public metadata yet.
send_actionShow typing indicator, "sending photo/video/audio/file", mark as read
Show typing indicator, "sending photo/video/audio/file", mark as read
No parameter schema in public metadata yet.
get_bot_infoBot info: name, ID, username, description
Bot info: name, ID, username, description
No parameter schema in public metadata yet.
get_chatsList all group chats the bot participates in
List all group chats the bot participates in
No parameter schema in public metadata yet.
get_chatFull chat details: participants, pinned message, owner
Full chat details: participants, pinned message, owner
No parameter schema in public metadata yet.
edit_chatRename chat, change description or icon
Rename chat, change description or icon
No parameter schema in public metadata yet.
get_chat_membersList chat members with roles
List chat members with roles
No parameter schema in public metadata yet.
get_adminsList chat administrators with permissions
List chat administrators with permissions
No parameter schema in public metadata yet.
set_adminGrant admin rights to a member
Grant admin rights to a member
No parameter schema in public metadata yet.
remove_adminRevoke admin rights
Revoke admin rights
No parameter schema in public metadata yet.
add_membersAdd users to a group chat
Add users to a group chat
No parameter schema in public metadata yet.
remove_memberRemove a user from a group chat
Remove a user from a group chat
No parameter schema in public metadata yet.
get_updatesIncoming events: messages, button presses, new dialogs (long polling)
Incoming events: messages, button presses, new dialogs (long polling)
No parameter schema in public metadata yet.
answer_callbackRespond to inline button press: show notification or update message
Respond to inline button press: show notification or update message
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MAX_TOKEN*secretMAX bot token from dev.max.ru — passed as Authorization header WITHOUT 'Bearer' prefix (MAX API quirk: non-standard auth)
Readme
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)
Details
- Repository
- github.com/woyaxnini/mcp-max-messenger
- Category
- Media & Entertainment
- Package
@woyax/mcp-max-messenger- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from woyaxnini
Related Media & Entertainment MCP servers
View all
Rootvine Mcpragingorangutan/rootvine-mcpNeutral commerce resolution for AI agents — music live, ranked by trust, never by commission.3stars
Image Tools - Background Removal, Upscaling & Face Restorationfasuizu-br/speech-ai-examplesBackground removal, 4x upscaling, and face restoration via GPU0starsNLP Tools - Sentiment, NER, Toxicity & Language Detectionfasuizu-br/speech-ai-examplesToxicity, sentiment, NER, PII detection, and language identification tools0stars
ScrapeBadgerscrape-badger/scrapebadger-mcpTwitter/X, Google, Facebook Marketplace, Yelp, GitHub and AutoScout24 for AI agents.2stars
Post for Me MCP Prohelbertparanhos/postforme-mcp-proPublish, schedule and analyze social posts across 9 platforms via the Post for Me API.1stars