MAX MCP

Install

git clone https://github.com/renosaza/max-mcp.git ~/max-mcp
cd ~/max-mcp
uv sync --frozen
uv run max-mcp-login login-qr

This is third-party code. Review the repository files before installing.

What it does

The server signs into MAX as your device and gives the agent eight tools. The agent lists dialogs, groups and channels, reads history with pagination, searches text in a chosen chat and exports channel posts with reactions, up to a thousand per call. It can also send a message, reply or file. Only files from allowed folders can be sent; SSH, AWS and system paths are blocked.

Who it is for. SMM specialists and analysts who work with MAX channels and chats.

Example request

Find messages with the word «договор» in chat 123456, scanning at most 1000 messages

Limitations

It uses the unofficial maxapi-python client and a user session, so the MAX protocol may change without notice. The author recommends a separate account for experiments. Runs on macOS and Linux with Python 3.11-3.13 and uv. Search reads history sequentially, and large channels take several export calls.

How to disable. Run claude mcp remove max-mcp, unlink the device in MAX settings and delete the session from ~/.max-mcp/.

MCP

Transport

stdio

Authentication

not required

Security check

• Sends messages and files as your account
• Uses an unofficial client, so the account may be restricted
• A session with access to all chats is stored locally

README in short

The Russian README lists eight tools and warns up front about the unofficial client and account restriction risk. It covers install via uv, QR or SMS login, connecting Claude Code and sample prompts. It explains file sending rules and re-authentication, lists limitations and links to tool and troubleshooting docs. MIT license.

Related