# max-messenger

Connects AI assistants to VK's MAX Messenger using the MCP protocol. Enables tools to read conversations, dispatch media files, and manage group chats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: woyaxnini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/woyaxnini/mcp-max-messenger
- Updated: 2026-03-31
- HTML: https://affpapa.org/en/nevibecode/mcp/max-messenger

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MAX_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add max-messenger -e MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messenger
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add max-messenger --env MAX_TOKEN=<MAX_TOKEN> -- npx -y @woyax/mcp-max-messenger
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "max-messenger": {
            "command": "npx",
            "args": [
                "-y",
                "@woyax/mcp-max-messenger"
            ],
            "env": {
                "MAX_TOKEN": "<MAX_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "max-messenger": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@woyax/mcp-max-messenger"
            ],
            "env": {
                "MAX_TOKEN": "<MAX_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MAX_TOKEN=<MAX_TOKEN> max-messenger npx -y @woyax/mcp-max-messenger
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [vk](https://affpapa.org/en/nevibecode/mcp/vk.md) — MCP server · ★ 16
- [mvvm-toolkit-messenger](https://affpapa.org/en/nevibecode/skills/mvvm-toolkit-messenger.md) — skill · 56 installs
- [conversational-ux](https://affpapa.org/en/nevibecode/skills/conversational-ux.md) — skill · 1100 installs
- [chatbot-flow-design](https://affpapa.org/en/nevibecode/skills/chatbot-flow-design.md) — skill · 339 installs
- [ui-ux-pro-max](https://affpapa.org/en/nevibecode/skills/ui-ux-pro-max.md) — skill · 417000 installs
- [ui-ux-pro-max-skill](https://affpapa.org/en/nevibecode/skills/ui-ux-pro-max-skill.md) — skill · 2000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md