mcp-max-messenger

21 toolswith full coverage of MAX Bot API.

- 🇷🇺 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

Mac:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.json

"Who are the members of the sales group? Make Alex an admin."

"Check for new incoming messages and button presses"

# Local stdio mode (default) npx @woyax/mcp-max-messenger # Remote HTTP mode npx @woyax/mcp-max-messenger --transport http --port 3000

Two independent layers — tools work identically in both modes:

src/ ├── core/ # Business logic — shared between modes │ ├── max-client.ts # MAX API HTTP client │ ├── types.ts # TypeScript types for MAX API │ └── tools/ │ ├── bot.ts # get_bot_info │ ├── chats.ts # get_chats, get_chat, edit_chat, send_action │ ├── messages.ts # send/get/edit/delete/pin/unpin, send_media │ ├── members.ts # get_chat_members, get_admins, set/remove_admin, add/remove_members │ └── updates.ts # get_updates, answer_callback ├── transports/ # Transport layer — selected at runtime │ ├── stdio.ts # Local mode (Claude Desktop, Cursor) │ └── http.ts # Remote mode (Streamable HTTP) └── index.ts # Entry point: transport selection

- Authorization: Token passed asAuthorization: <token>—noBearerprefix
- Base URL:https://platform-api.max.ru
- Rate limit: 30 requests/second
- Group chats:GET /chatsreturns group chats only
- Personal dialogs: Accessible viaget_updates— use the returnedchat_idwith all standard tools
- Media upload: Two-step process (upload → send). Audio/video tokens come from the upload step, not the file transfer
- HTTP transport: Uses Streamable HTTP (SSE deprecated since MCP SDK 1.10.0)

- remove_adminmay returnsuccess: truewithout actually revoking rights — confirmed bug on MAX side
- open_appbutton type returns "Field 'webApp' cannot be null" — MAX API bug
- add_membersmay fail withadd.participant.privacyif the user has privacy mode enabled

- HTTP mode testing on VPS with n8n integration
- Hosted MCP service (connect by URL, no local install)
- Webhook support for real-time event handling
- answer_callbacktesting via n8n webhook workflow

Built byOleg Alekseev— ERP/AI integration architect.

Manage your WhatsApp, SMS and Phone Calls using a single MCP connector

Send Push Notifications and Live Activities to your paired iOS devices.

Connect to any function, any language, across network boundaries using AgentRPC.

Secure audio transcription meets AI. Connect Alice recordings to Claude, ChatGPT, Gemini, and more.

Access your meeting transcripts, summaries, and action items from any AI assistant.

Schedule and queue text, image, and video posts to many social networks, including LinkedIn, X, Bluesky, Instagram, Facebook, Threads, Tiktok.

Network access with the ability to run commands like ping, traceroute, mtr, http, dns resolve.

Connect Claude, ChatGPT, and other AI tools to your Granola meeting notes via MCP. Query your notes, search transcripts, and get meeting insights in your favorite AI assistants.