HQBase

Overview

HQBase is an open-source shared email workspace for teams that runs in the customer's Cloudflare account. It provides shared mailboxes, team access controls, multi-domain setup, drafts, audit history, and an OAuth-protected remote MCP server for AI clients. Mail and credentials remain in infrastructure the customer controls.

Key Features

• Shared mailboxes with team access controls for managing permissions by mailbox.
• Multiple domains and mailboxes in one workspace, with drafts and audit history.
• Email via MCP: AI clients connect over OAuth to search, draft, reply, and send.
• A desktop and mobile PWA client with self-hosted push notifications for access anywhere.
• Runs in the customer's Cloudflare account, so the Worker, D1 mail index, and R2 attachments stay theirs.
• Installation, update, backup, and recovery operations with release verification and rollback support.

Use Cases

• Teams that need shared mailboxes while keeping mail and credentials in infrastructure they control.
• Organizations managing multiple domains and team mailboxes from one workspace.
• Teams that want AI clients to search, draft, reply, and send email through an OAuth-protected MCP server.
• Users who need desktop and mobile access to shared team email through a PWA.

Getting Started

• Deploy HQBase to Cloudflare or read the product documentation. For local development, run pnpm install, pnpm db:migrate:local, pnpm db:seed:local, and pnpm dev. Before the optional seed command, add BETTER_AUTH_SECRET and HQBASE_LOCAL_SEED_PASSWORD with 8 to 128 characters to

Deployment & Requirements

• Enable Workers Paid, activate the R2 subscription, and have an active domain using Cloudflare DNS.

Before You Adopt

• License: AGPL-3.0. Review its terms before using, modifying, or distributing the project.