Log inSubmit server
MAX CLI logo

MAX CLI

Connects AI agents to MAX personal accounts and bots for reading, searching, reviewing, and sending messages.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MAX CLI

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "max-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/max-cli"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @wirecat/max-cli

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 2d ago.

Overview

MAX CLI provides a local MCP server for MAX personal accounts and bots, letting agents read chats, search local history, review conversations, and prepare or send replies. It runs through the `max personal mcp` command and can also be used as a terminal CLI with installed agent skills. Reach for it when an agent needs access to MAX conversations, local offline search, voice transcription, or controlled write access. Personal-account access uses MAX’s unofficial internal API, while bot access uses the official Bot API.

Use cases

  • Review recent MAX chats for promises and unanswered requests
  • Search locally cached messages without an internet connection
  • Draft and send replies with controlled write permissions
  • Monitor group conversations and flag rule violations
  • Connect MAX conversations to Claude, Codex, Cursor, or Gemini CLI

Key features

  • Local MCP server for MAX personal accounts and bots
  • Offline search over locally stored conversations
  • Voice-message transcription on the local computer
  • Read-only profiles, writable-chat restrictions, and rate limits
  • CLI skills for Claude Code, Codex, Cursor, and Gemini CLI
  • JSON output with stable error exit codes

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @wirecat/max-cli (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads5.2kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.

How MAX CLI works

What MAX CLI does

MAX CLI connects MAX messaging data to terminal workflows and MCP-compatible AI clients. It supports both a personal MAX account and bots, with separate access paths for each. Personal-account features cover chats, message history, groups, contacts, files, attachments, and voice messages; voice messages can be transcribed locally.

Agents can inspect unread conversations, search messages, review recent exchanges for promises and pending responses, watch for new messages, and create replies. Sending is available when the selected profile and permissions allow it. The CLI also supports reactions, message editing, forwarding, polls, and scheduled sending, as well as checks for unanswered questions and group rules in groups managed by the user.

How it works

The personal account is added as another MAX device after QR-code authentication, with SMS login available through web.max.ru. Read content is stored in a local copy, enabling searches and reading in offline mode. Commands can emit JSON for scripts, while errors are returned separately with stable exit codes.

For AI agents, the max personal mcp command starts the local MCP connection. Agent skills provide command instructions and constraints for Claude Code, Codex, Cursor, and Gemini CLI. MCP clients can use predefined requests such as /catch-up, /review, /reply, and /find.

Profiles can be configured as read-only, restricted to an approved set of writable chats, or limited by a messages-per-hour rate. Reading does not mark messages as read by default, and the CLI avoids choosing between ambiguous chat matches.

Setup and configuration

Install the package globally with npm, then authenticate and optionally install an agent skill:

Terminal
npm install -g @wirecat/max-cli
max personal setup
max skill install --for all

max personal setup guides QR login and can install skills for a selected agent with --agent claude, codex, cursor, gemini, all, or none. The CLI can also be tested without a global install using npx @wirecat/max-cli --help.

The supported runtimes are Node.js 22.16 or newer in the 22.x line, Node.js 24 or newer, or Bun 1.3 or newer. Windows, macOS, and Linux are supported. Add the MCP configuration with max personal mcp add claude-code or max personal mcp add codex; max personal mcp config generates configuration for Claude Desktop, Cursor, and other clients. Profiles that can send messages require explicit confirmation before MCP write access is enabled.

Tools and capabilities

  • Read unread messages without marking them read.
  • Search the locally stored conversation copy, including offline searches.
  • Review recent conversations and identify promises or expected replies.
  • Transcribe voice messages locally.
  • Draft and send replies subject to profile permissions.
  • Export data as JSONL or Markdown.
  • Inspect and moderate group activity using configurable checks that mark findings by default.
  • Access MAX bots through the official Bot API.

Limitations and notes

Personal-account operations use MAX’s unofficial internal API, which may change without notice and may conflict with MAX service terms. Bot operations use the official Bot API and are separate from that limitation.

The personal-account feature set does not include circles or two-step password settings. Write operations should be configured carefully because a default profile may be able to send messages. If a connection fails during sending, the CLI reports the failure and is designed not to create a duplicate when the operation is retried.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MAX CLI

MAX CLI is an MCP server that connects AI agents to MAX personal accounts and bots, exposing tools for inboxes, local message search, conversation reviews, voice transcription, and controlled replies. Personal accounts use MAX’s internal API, while bot access uses the official Bot API.

Install it with `npm install -g @wirecat/max-cli`, then run `max personal setup` to authenticate and configure a profile. Use `max personal mcp config` for client configuration, or `max personal mcp add claude-code` or `codex` for those clients.

Run `max personal mcp config` to create MCP configuration for Claude Desktop, Cursor, and other clients. Authenticate the personal profile first with `max personal setup`; profiles that permit sending require explicit write authorization before MCP setup completes.

Yes. MAX CLI searches a local copy of read conversation data, including with commands such as `max personal search all "встреча Алиса"`. Offline reading and searching use that local copy rather than making requests to MAX.

Yes. MAX CLI supports separate bot access through the official MAX Bot API, in addition to personal-account access. Personal-account operations use MAX’s unofficial internal API and are subject to different service and compatibility considerations.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMAX CLI AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/max-cli?style=directory)](https://allmcps.com/mcp/max-cli)
HTML Embed
<a href="https://allmcps.com/mcp/max-cli"><img src="https://allmcps.com/api/badge/max-cli?style=directory" alt="MAX CLI on AllMCPs" /></a>