SkillFoxx

Max 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

  • 1 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • Reads private messages and attachments from every chat the bot has access to
  • The bot token grants full chat access until revoked
All reasons and checks
Russian stack

ammite/max_bot_messages_parsingAuthor:Ammite

Install

Manual install

claude mcp add max-bot -- env MAX_BOT_TOKEN=ваш_токен_бота python server.py

Command from the README, requires pip install -r requirements.txt beforehand.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Reads private messages and attachments from every chat the bot has access to
  • The bot token grants full chat access until revoked

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

What it does

The server wraps the Max Bot API in six read-only tools: list the bot's chats, list a chat's members, fetch messages with date filters and pagination, case-insensitive text search, and download audio or any file attachment. It cannot send messages as the bot. Search is capped at 5000 scanned messages by default, all HTTP requests to Max have a timeout, and file downloads are guarded against path traversal.

Who it is for. For developers who already run a bot in Max and want to give Claude Code access to its chats for analysis and search.

Good fit when

  • You want to find messages by keyword in a Max bot's chats
  • You want to pull messages for a date range with pagination
  • You need to download an attachment from a message in a specific chat

Not a fit when

  • You need to send messages or reply as the bot: the server is read-only
  • You need access to a personal Max account rather than a bot

Example request

Find messages containing the word report in chat 12345 from the last week

MCP

Transport
stdio
Authentication
API key

Environment variables

MAX_BOT_TOKEN required, secret
Max bot token, issued via @MasterBot

Limitations

The project is very small: a single server.py file, 1 star, one author. There is no npm or pip package install and no tests. You need your own Max bot with a token from @MasterBot.

How to disable. Remove the server with claude mcp remove max-bot and revoke the bot token via @MasterBot if needed.

FAQ

Can the server send a message as the bot?

No, all tools only read chats, members and messages.

How many messages does search scan?

Up to 5000 messages per chat by default, a limit set in the server code.

Discussion

No questions or reviews yet.

All MAX messenger tools
Russian stack

MCP server for MAX messenger Bot API: messages, media, chats, participants and buttons from an agent

MCP serverExtended access12
Russian stack

An MCP server for the MAX messenger (formerly VK Teams): sending and reading messages, chat management, pinning and typing status

MCP serverBroad access

MAX MCP

max-mcp

Russian stack

Local MCP server for MAX messenger using a user session: chats, search, channel export, sending messages and files

MCP serverBroad access6
Official

Hosted MaxStat MCP server for searching and analyzing channels and posts in the MAX messenger

MCP serverExtended access3

MAX plugin for OpenClaw

openclaw-max-plus

Russian stack

A channel plugin that connects the OpenClaw AI assistant to the MAX messenger via the official Bot API: text, media, buttons, streaming, multiple accounts

PluginExtended access

MAX AI secretary guide

clawbot-max-guide

Russian stack

A set of simplified Python examples for assembling a personal AI secretary in the MAX messenger via the Bot API, User API and MCP

WorkflowBroad access2

README in short

A short Russian README describes six tools, installation via pip install -r requirements.txt, and connecting with claude mcp add and the MAX_BOT_TOKEN variable. A separate security section mentions the token passed only through an environment variable, path traversal protection on file downloads, a scan limit for search and request timeouts.

README badge

Report a problem