Our take
- Activity
- 67
- Community
- 47
- Issues
- 76
- Pull requests
- 47
+23 stars in the last 30 days
- Closes issues faster than 82% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,930Forks
294Change since Nov 16, 2026: 0 stars·+1 forks
Overview
mautrix-whatsapp is a bridge between WhatsApp and Matrix. It uses a puppeting model, linking a WhatsApp account so its conversations can be accessed through Matrix, rather than providing a separate WhatsApp client.
It is intended for people who use Matrix and want to bring WhatsApp into that environment. The bridge is built on whatsmeow; consult its documentation and roadmap to confirm current support for the capabilities you need.
Key Features
- Connects WhatsApp and Matrix through a bridge.
- Uses a puppeting model for linking a WhatsApp account.
- Built on the Go library whatsmeow.
- Provides separate documentation for setup and authentication.
- Offers setup guidance for both general installations and Docker.
- Maintains a roadmap describing supported functionality.
Use Cases
- Matrix users who want to access WhatsApp conversations from their usual Matrix client.
- People who manage messaging across Matrix and WhatsApp and prefer a bridged workflow.
- Matrix administrators evaluating a WhatsApp bridge for their homeserver, after checking the current setup requirements and roadmap.
Getting Started
Start with the bridge setup guide, or use the Docker setup guide. See the authentication guide for linking an account. The repository README points to these resources and the roadmap.
Alternatives
- matterbridge: Matterbridge relays messages between configured platform accounts, while mautrix-whatsapp puppets a WhatsApp account for a Matrix user.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| mautrix-whatsapp | Go | AGPL-3.0 | 1.9k | Not checked yet |
| matterbridge | Go | Apache-2.0 | 7.6k | Inactive |
Considerations
- This is a bridge, not an independent WhatsApp client. It requires a Matrix environment as well as a WhatsApp account to link.
- The project depends on whatsmeow and on WhatsApp connectivity, so behavior and supported capabilities may depend on those systems.
- Check the roadmap for the current support status of specific features before deployment.
- The AGPL-3.0 license should be considered when using or distributing the software.
Found this useful?
Share it with someone who would like mautrix-whatsapp.