MAX MCP
max-mcp
Local MCP server for MAX messenger using a user session: chats, search, channel export, sending messages and files
- 5 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- 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
Install
- Works in
- Services
Manual install
git clone https://github.com/renosaza/max-mcp.git ~/max-mcp
cd ~/max-mcp
uv sync --frozen
uv run max-mcp-login login-qrScan the QR code in the MAX mobile app under linking a new device.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- 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
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.
Good fit when
- You need to export channel posts to JSON for analysis
- You need to find messages in a chat by keyword
- You need to send a report to a chat from the agent session
Not a fit when
- You need mass messaging: that is a direct path to account restrictions
- You cannot risk your main MAX account
Example request
Find messages with the word «договор» in chat 123456, scanning at most 1000 messagesMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
MAX_MCP_SEND_ROOTS- Colon-separated folders allowed for sending files
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/.
FAQ
How do I log in without a QR code?
Use uv run max-mcp-login login-sms --phone with your phone number.
Where can files be sent from?
By default ~/Downloads, ~/Documents and /tmp. Set your own list with MAX_MCP_SEND_ROOTS.
Discussion
No questions or reviews yet.
Related
All MAX messenger toolsMax Bot MCP server
Max Bot MCP Server
An MCP server that reads a bot's messages in the Max messenger: chats, members, text search and attachment downloads
MCP server for MAX messenger
mcp-max-messenger
MCP server for MAX messenger Bot API: messages, media, chats, participants and buttons from an agent
Hosted MaxStat MCP server for searching and analyzing channels and posts in the MAX messenger
MAX messenger MCP server
mcp-server-max
An MCP server for the MAX messenger (formerly VK Teams): sending and reading messages, chat management, pinning and typing status
MAX channel for Claude Code
max-gateway
A robust daemon and bridge plugin: talk to your Claude Code session from the MAX messenger, with photos, voice and buttons
An MCP server generates, translates and publishes posts to Telegram, VK, MAX and Threads: brand profile, competitor analysis and images in one pipeline
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.