Skip to main content
Glama

wbot

wbot is an Agent-first, read-only interface to authorized WeChat conversations. This public repository owns the single wbot command, its MCP runtime, and the Codex and Claude Code plugins. The private Switchboard backend remains outside this repository.

Install

Install Bun, then install the latest verified GitHub Release artifact:

bun add --global "@celados/wbot@https://github.com/celados/wbot/releases/latest/download/wbot.tgz"
wbot auth set
wbot @schema

For internal dogfood against the test deployment, explicitly select its HTTP Actions origin:

WBOT_PLATFORM_URL=https://wbot-api-test.celados.com \
  wbot conversations.list '{ "limit": 50 }'

See the package README for CLI, MCP, credential, and cursor semantics, and the package changelog for release and migration notes.

Conversation results expose the Tenant's read and send capabilities. Conversation and message update results also expose capture freshness, allowing Agents to distinguish quiet conversations from delayed, unavailable, or insufficient capture evidence without accessing private operator diagnostics.

Related MCP server: wx4py-mcp

Public endpoints

The Agent CLI and MCP use the production HTTP Actions origin https://wbot-api-prod.celados.com. https://wbot-cloud-prod.celados.com is the separate Convex API/WebSocket origin for browser clients and is not a CLI or MCP base URL. Internal test dogfood explicitly sets WBOT_PLATFORM_URL to https://wbot-api-test.celados.com; no test-specific command is published.

Development

bun install --frozen-lockfile
bun run check
bun run test
bun run verify:package

Changing packages/wbot/package.json version on main creates an immutable tag and public GitHub Release after all gates pass.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A WeChat robot server based on the Model Context Protocol that enables AI agents to send and receive messages and manage typing status. It provides tools for QR code login, long-polling message retrieval, and persistent state management across various MCP clients.
    33 npm
    108
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Read-only MCP server for Telegram that enables reading messages and transcribing voice, audio, and video notes via the Telegram API for use with Codex and Claude Code.
    Apache 2.0