max-messenger — Claude Code MCP server: what it does, how to install
Connects AI assistants to VK's MAX Messenger using the MCP protocol. Enables tools to read conversations, dispatch media files, and manage group chats.
claude mcp add max-messenger -e MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messengerWhat max-messenger does
The server exposes 21 distinct tools mapped to the MAX Bot API. Your coding assistant can post formatted text in HTML or Markdown, handle five button variants, pin notices, and track incoming events through long polling.
Execution relies on two runtime choices: local stdio mode or a remote http transport on port 3000. Running it requires Node.js 18+ and an active bot token inside the MAX_TOKEN environment variable.
The underlying platform restricts traffic to 30 requests per second. The authorization header omits the standard Bearer prefix. Adding group participants will fail whenever an account restricts invitations via privacy settings.
What it helps with
- send rich messages with interactive buttons into MAX chats
- upload audio, video, and image attachments via direct URLs
- manage chat members and update administrator permissions
- listen for incoming messages and button callbacks using long polling
Example prompts for the agent
- Send a project update with confirmation buttons to the team chat
- Fetch recent messages from the announcement channel and pin the latest one
- Review the member roster and revoke admin permissions for user 123456789
How to install max-messenger
Platform CLI
claude mcp add max-messenger -e MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messengerReplace <…> with your own values
Platform CLI
codex mcp add max-messenger --env MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messengerReplace <…> with your own values
Config file
{
"mcpServers": {
"max-messenger": {
"command": "npx",
"args": [
"-y",
"@woyax/mcp-max-messenger"
],
"env": {
"MAX_TOKEN": "<MAX_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"max-messenger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@woyax/mcp-max-messenger"
],
"env": {
"MAX_TOKEN": "<MAX_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MAX_TOKEN=<MAX_TOKEN> max-messenger npx -y @woyax/mcp-max-messengerReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about max-messenger
How do I install max-messenger in Claude Code?
Run claude mcp add max-messenger -e MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messenger. Make sure to replace <MAX_TOKEN> with your actual bot credentials.
What does max-messenger do?
It hooks AI clients into the MAX platform through 21 dedicated tools. The model can dispatch media, format notices, adjust chat roles, and capture events.
What are the prerequisites for running this MCP server?
You need Node.js 18+ installed on your system. You also have to create a bot on max.ru to receive an access token.
