mcp-max-messenger

by woyaxnini

277 downloads Not rated yet

GitHub Website

Communication

About

mcp-max-messenger Browse Max Messenger MCP Server for Claude, Cursor, VS Code, and other AI agents.

Explore

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name mcp-max-messenger

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-max-messenger": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@woyax/mcp-max-messenger"
                ],
                "env": {
                    "MAX_TOKEN": ""
                }
            }
        }
    }
}

McpServers

{
    "server": {
        "command": "npx",
        "args": [
            "-y",
            "@woyax/mcp-max-messenger"
        ],
        "env": {
            "MAX_TOKEN": ""
        }
    }
}

Transport

"stdio"

Package

"@woyax/mcp-max-messenger"

Registry

"npm"

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 openModel Context Protocolstandard.

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

- Node.js 18+
- A MAX bot token (create a bot at max.ru)

Mac:~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:%APPDATA%\Claude\claude_desktop_config.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.

MAX_TOKEN=YOUR_BOT_TOKEN MCP_TRANSPORT=http MCP_PORT=3000 npx @woyax/mcp-max-messenger

Connect any MCP client tohttp://your-server:3000/mcp.

5 button types supported:callback,link,message,request_contact,request_geo_location.

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"

"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

- MAX Bot API Documentation
- MAX OpenAPI Schema
- Model Context Protocol
- npm package
- Russian README

Built byOleg Alekseev— ERP/AI integration architect.

- 📧[email protected]·[email protected]
- 💬 Telegram:@ale_oleg· Channel:@woyax_ai
- 💬 MAX:max.ru/id503610654564_biz

Need help integrating AI agents with your ERP, CRM, or MAX? Custom MCP servers, n8n workflows, AI automation —contact me.

Free to use for personal and corporate purposes. Selling as a hosted service requires author's permission. See LICENSEfor details.

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.

Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

Claude Desktop / Cursor

McpServers

Transport

Package

Registry

More like this

Slack

Inbox Zero

Production-ready MCP integrations for AI applications

whatsapp-mcp