mautrix

mautrix-whatsapp: Bridge WhatsApp to Matrix

mautrix-whatsapp connects WhatsApp accounts to Matrix through a puppeting bridge based on whatsmeow. It is for Matrix users who want to access WhatsApp conversations from their Matrix client, with setup and authentication documented by the project.

View on GitHub Compare
Stars
1.9k
Forks
285
Stars, last 30 days
+23

Our take

Health score

59/100

How it is scored
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.

Selected snapshot

Stars

1,930

Forks

294

Change 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.
ProjectLanguageLicenseStarsStatus
mautrix-whatsappGoAGPL-3.01.9kNot checked yet
matterbridgeGoApache-2.07.6kInactive

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.

Comparisons