matcha

---

Tip

There are nightly releases!

A powerful, feature-rich email client for your terminal. Built with Go and the Bubble Tea TUI framework, Matcha brings a beautiful, modern email experience to the command line with support for rich content, multiple accounts, and advanced terminal features.

Plugin Marketplace

Matcha has a built-in plugin system with 35+ community plugins. Browse and install them from the terminal or the online marketplace.

matcha marketplace                # browse plugins in the TUI
matcha install <url_or_file>      # install a plugin
matcha config <plugin_name>       # configure an installed plugin

Anyone can submit their own plugin — just add an entry to plugins/registry.json and open a PR. Learn more

Logging

Matcha supports global logging verbosity flags before the main command or subcommand:

matcha --verbose              # enable verbose logging
matcha -V daemon status       # short form for verbose logging
matcha --debug daemon status  # enable debug logging

The existing -v and --version flags continue to print the Matcha version.

On macOS, Matcha ships with an optional menu bar helper. It lives in the menu bar and shows your unread count, posts native notifications with the Matcha icon on new mail, and lists your accounts so you can open Matcha in a terminal with a click. It talks to the Matcha daemon, so no extra configuration is needed.

matcha helper install     # build & start the menu bar app (runs at login)
matcha helper status      # check whether it's installed and the daemon is up
matcha helper uninstall   # remove it

Building the helper uses the Xcode Command Line Tools’ swiftc (the same requirement as matcha setup-mailto).

Documentation

Matcha Documention is available on our website

Star History

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. See CONTRIBUTING.md for guidelines.

License

This project is distributed under the MIT License. See the LICENSE file for more information.

Suggestions

For general suggestions and community discussion, please join our Discord server.

For security-related issues, please refer to the Security Policy.

For urgent concerns, contact [email protected]

Sponsors

Tip

Want to sponsor our development and be featured here? You can do so here (or, if you prefer, here), or discuss it via email with our team

Thank you to our sponsors for supporting Matcha’s development!

Individual Sponsors:

David H. Colmenares | Elliot Hornes | Robert M. | James L. | Chris D.

Vault kin (added at capture)

Terminal email client — the note comparing it with neomd (OSS) (same capture window): matcha = the extensible-platform pole (plugins/marketplace/accounts/rendering), neomd = the opinionated-workflow pole (HEY screener + GTD + Markdown). First to ship a clean CLI/MCP surface owns the agents-and-email lane.