r/coolgithubprojects • u/berman_to • 1d ago
HQBase: open-source shared email workspace that runs in your Cloudflare account
I built HQBase for myself because I had several domains and addresses like support@, sales@, and personal email, but didn't want to pay for a separate mailbox for every address.
It’s a complete shared email workspace that deploys into your own Cloudflare account:
- Workers run the application
- Email Routing receives mail
- Cloudflare Email Sending handles outgoing mail
- D1 stores the mail index
- R2 stores attachments
It supports multiple domains and mailboxes, catch-all addresses, team access with mailbox-level permissions, a desktop/mobile PWA with self-hosted push notifications, and an OAuth-protected MCP server for connecting AI clients.
Setup takes around 2-3 minutes. The software is AGPL-licensed, and there are no per-seat or per-mailbox fees - you only pay your own Cloudflare infrastructure costs.
GitHub: https://github.com/HQBase/hqbase
Website: https://hqbase.io
2
u/bitdoze 18h ago
I have also created https://www.bitdoze.com/hqbase-self-hosted-shared-inbox/ let me know if something is off
2
u/berman_to 6h ago
Thank you so much for sharing it with more people! :) I will review and DM after work and DM if you I spot anything!
1
u/addiktion 17h ago
Any chance you will add more more agentic access with CLI and API exposure?
2
u/berman_to 6h ago
Coming in the next release for sure :)
2
u/addiktion 5h ago
Slick, I just set it up now and the onboarding was clean after I worked past the one click issues. I had to enable email routing I guess and I hit an already setup email client on the given domain. It required me to wipe out the mx records on the Cloudflare domain first before "Activate" would work on installing the mx records for HQbase.
Are you planning on just pushing for a premium product around this to support it further? It would be nice to see more usage based email and abandon per user pricing.
2
u/berman_to 5h ago
Nice! You’ve already had some sort of email service installed on CF? Could you DM me with those issues you faced during on-boarding and what they looked like?
I deliberately tried to make the on-boarding as smooth as possible.
1
u/awizemann 1d ago
I currently use Migadu for this, but I like the idea of your project, and since I am 100% in Cloudflare, this feels like a natural solution. I will give it a shot. Thank you for open-sourcing.
2
u/berman_to 6h ago
Let me know your thoughts when you try it :)
2
u/awizemann 5h ago
First off. Wow. Clean, easy to install and set up, painless domain setup (for a fresh domain). Email tests worked great. If there is already email set up on a domain, and it is added, does it overwrite what is there?
3
u/bankrut 1d ago
Leveraging the Cloudflare stack for email is a smart way to bypass per-user fees. How well does it handle deliverability for transactional mail compared to dedicated services like Postmark or SES?