About hieunc229/mailflare
hieunc229/mailflare is an open-source project on GitHub, mainly written in TypeScript. Email for professionals and teams It currently holds 6,752 stars and 1,156 forks with 37 open issues, and was last pushed on 2026-11-16 (repository created 2026-05-26).
Project Overview
Git Homed tracks it on the Today's Trending board, currently at rank #36 with 254 new stars today.
GitHub Repository Details
README
Mailflare
A self-hosted alternative to Google Workspace. Setup custom domain Emails, Calendar, Drive, Booking and built-in AI agents.
Run it on Cloudflare or Docker. Send and receive with Cloudflare, Resend or Amazon SES. Store files in R2, Backblaze B2 or AWS S3. Use D1, Postgres, MySQL or Turso for the database.
Screenshots
![]() Inbox |
![]() Domains |
![]() Mailboxes |
![]() Calendar |
![]() Booking |
![]() Drive |
Sponsors
Want to support Mailflare? Become a sponsor.
Features
Apps
- Email: Custom domain mailboxes, personal or shared, with access you control. Send and receive with Cloudflare Email, Resend or Amazon SES.
- Routing rules: Store, forward, reject or sort incoming mail.
- Calendar: Repeating events with time zones. Attendees get email invitations.
- Booking: Share a public link so anyone can book a free time on your calendar.
- Drive: Store and share files.
- AI agents: Search mail, draft replies and manage events. Connect other AI tools over MCP.
Technical
- Databases: Cloudflare D1 (default), PostgreSQL, MySQL, Turso / libSQL, or a local SQLite file. Set
DATABASE_URLto switch. Works with Supabase, Neon, PlanetScale, TiDB and more. See Databases. - File storage: Cloudflare R2, Backblaze B2 or AWS S3.
- Hosting: Cloudflare Workers or a single Docker container.
- Admin: Users, API keys, webhooks, audit logs and backups.
- Import: Bring in mail from IMAP, Gmail Takeout,
.emland.mboxfiles.
Cost
You can receive and send mail for free.
- Receiving: Cloudflare Email Routing is free.
- Sending: Use the free tier of Resend (3,000 emails a month) or Amazon SES. Cloudflare's own sending needs the $5/month Paid Worker plan.
Deploy
1. Deploy the app. Click Deploy to Cloudflare. Keep the app name mailflare, or it will break.
2. Finish setup. Open the app at /setup and create your admin account.
3. Connect a domain. Add a domain from the same Cloudflare account, then create your first mailbox.
CF_TOKEN is required. Create a scoped Cloudflare API token with these permissions:
> - All accounts: Email Sending:Edit, DNS Settings:Edit, Email Routing Addresses:Edit
- All zones: DNS Settings:Edit, Email Routing Rules:Edit, Zone Settings:Edit, DNS:Edit
More options: deployment guide.
Deploy with an AI agent
Paste this into an AI agent that has terminal access (Claude Code, Codex, Cursor and similar):
Install Mailflare for me from https://github.com/hieunc229/mailflare on my Cloudflare account.
1. Read README.md, docs/deployment.md and wrangler.jsonc first.
2. Ask me for my Cloudflare account ID and two API tokens, using a secret input:
a deploy token (for Wrangler) and a runtime token (the Worker secret CF_TOKEN).
Never print them, commit them, or pass them as command arguments.
3. Keep the Worker name exactly "mailflare". Create or reuse the D1 database
"mailflare", the R2 bucket "mailflare-raw", and the queues "mailflare-inbound",
"mailflare-outbound" and "mailflare-agent".
4. Install dependencies, run npm run deploy, and set CF_TOKEN as a Worker secret.
Do not run remote database migrations yourself. The /setup page does that.
5. Give me the app URL and anything I still need to do. I will open /setup, create
the admin account and connect my domain.
Token permissions and more options: deployment guide.
Self-host with Docker
Runs as one container on any server, with SQLite and local files.
cp .env.docker.example .env.docker
docker compose up -d --build
See self-hosting.
Local development
cp .dev.vars.example .dev.vars
npm install
npm run db:migrate:local
npm run dev
Add your Cloudflare credentials to .dev.vars, then open localhost:3000. Run npm run db:seed to load sample data.
npm run build: build the Workernpm run deploy: build and deploynpm run lint: lint and type check
Documentation
- Deployment and configuration
- Databases
- Sending and receiving providers
- API and integrations
- Email assistant and MCP
- Adding a language
- Troubleshooting
License
See LICENSE.







