c3-py

> WhatsApp x Claude Code -- the first WhatsApp channel for Claude Code via MCP

> Status: Active Development -- this project is under active development. APIs may change. Contributions welcome.

[](https://github.com/vaddisrinivas/c3-py/actions) [](https://www.python.org/downloads/) [](LICENSE)

<!-- -->

c3-py is (probably) the first WhatsApp channel implementation for Claude Code. While Anthropic ships official channels for Telegram and Discord, WhatsApp has 2.5B+ users and no official channel. c3-py bridges that gap using Claude Code's MCP channel protocol, Baileys for WhatsApp connectivity, and a Markdown-based plugin system that lets anyone create AI agents without writing code.

Most WhatsApp bots are stateless request-response wrappers around an API. c3-py is different:

• Claude Code is the runtime -- Claude reads your plugin's Markdown, understands the rules, manages state across turns, and makes decisions. You write prose, not code.
• Native channel protocol -- uses Claude Code's notifications/claude/channel for real-time bidirectional communication, not polling or webhooks.
• Subagent architecture -- main agent routes to specialized agents (games, calendar, mealprep) registered at boot via --agents. Each plugin is a self-contained agent.
• WhatsApp-native UX -- polls for every choice, DMs for secret info, timers for phases. Not text menus pretending to be interactive.

---

• Python 3.11+
• Node.js 18+
• Claude Code CLI (authenticated via claude login)

# Install
pip install c3-py     # or: uv tool install c3-py

# Interactive setup -- checks