SkillFoxx

MAX channel for Claude Code plugin

max-gateway

A robust daemon and bridge plugin: talk to your Claude Code session from the MAX messenger, with photos, voice and buttons

  • 0 ★ on the repository
  • Last commit
Plugin

Broad access

Why this level

  • Gives direct access to a live Claude Code session through MAX messages
  • The /restart command can restart the session, and voice transcription is sent to the third-party Groq service
All reasons and checks
Russian stack

atomachinskiy/max-gatewayAuthor:atomachinskiy

Install

Works in

Manual install

MAX_BOT_TOKEN="<токен>" MAX_STATE_DIR="$HOME/.claude/channels/max-claude5" bun gateway/gateway.ts pair

Pairs with the MAX bot, capturing the owner's user_id and chat_id.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Gives direct access to a live Claude Code session through MAX messages
  • The /restart command can restart the session, and voice transcription is sent to the third-party Groq service

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

What it does

The project ports the same author's tg-gateway idea to the MAX Bot API: a daemon under systemd keeps a persistent MAX connection through a resilient long-poll that does not give up on the first network error, unlike mcp-max-messenger. A thin bridge plugin injects incoming messages into an open Claude Code session and sends replies back to MAX. Incoming: text, downloaded photos, voice and audio transcribed via Groq Whisper, video, files and button taps. Outgoing: chunked text, photos and files, inline buttons, threaded replies, a typing indicator (MAX bots have no emoji reactions). A command panel /menu /ping /status /screen /restart /logs /model /mcp with an admin allowlist covers server tmux deployments, plus a PID lock, watchdog, heartbeat and graceful restart. If the session or bridge blips, the daemon buffers incoming messages and loses nothing.

Who it is for. For people who want to message their Claude Code from MAX the same way they already do from Telegram.

Good fit when

  • You need a reliable MAX channel for Claude Code instead of a bridge with a fragile long-poll
  • You need to manage the session remotely: view the screen, status, restart by command from MAX
  • You need MAX voice messages transcribed right in the agent conversation

Not a fit when

  • You want a read-only channel without an admin panel and tmux deployment
  • You do not want to keep a systemd daemon running on a server permanently

Example request

From MAX to the bot: /status, then by voice message: restart the session and show the latest logs

Limitations

Voice transcription goes through Groq Whisper, so it depends on an external service. The daemon is built for a systemd system, and the server tmux deployment with an admin allowlist implies some setup. No license is stated in the repository.

How to disable. Stop and disable the daemon with systemctl --user disable --now max-gateway and remove the plugin with claude plugin uninstall max.

FAQ

How is this better than mcp-max-messenger?

According to the author, a resilient long-poll: the mcp-max-messenger version exits its poll loop on the first network error, while the max-gateway daemon does not.

Can an AI assistant install the project by itself?

Yes, the repo ships an AGENTS.md, a step-by-step install runbook covering bot creation, pairing, deployment per OS, plugin setup and removal.

Discussion

No questions or reviews yet.

All MAX messenger tools

MAX channel for Claude Code

claude-max-messenger-plugin

Russian stack

A Claude Code channel plugin for MAX messenger via Bot API: message the bot and Claude answers from the terminal, with pairing-code access

PluginBroad access5
Russian stack

A channel plugin that connects the OpenClaw AI assistant to the MAX messenger: text, attachments, buttons, pinning and webhooks

PluginExtended access7

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
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

openclaw-skill-max-bot (MAX)

openclaw-skill-max-bot

Russian stack

An OpenClaw skill that connects an agent to the MAX messenger: Long Polling, voice transcription through Whisper, typing indicator and channel publishing

SkillExtended access
Russian stack

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

MCP serverExtended access12

README in short

The Russian README describes the project as a reliable MAX channel for Claude Code, a port of the author's earlier tg-gateway. It lists capabilities: a resilient long-poll, incoming and outgoing content types, a command panel with an allowlist, a PID lock and a watchdog. It shows a bun-and-systemd quick start: creating a bot via @MasterBot, pairing to capture a user_id and chat_id, bringing up the daemon and connecting the bridge plugin via the marketplace. An env var table covers the bot token, state directory, admins, allowed chats, API base URL and tmux restart settings. It separately mentions AGENTS.md for AI-assistant-driven installation.

README badge

Report a problem