quickinbox
Quickinbox is a self-hosted email client built on Cloudflare Workers, delivering real-time mail to your domain with threads, attachments, and multiple user accounts.
Ficha actualizada 22 sept 2026, 21:25 · upstream 22 sept 2026, 20:59 · release v1.1.0
Qué es quickinbox
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Quickinbox provides a fully self-hosted webmail experience for any domain, eliminating reliance on third-party providers. The application runs entirely on Cloudflare Workers, meaning no dedicated servers are required — all email processing happens serverless within the same infrastructure that handles DNS resolution and SSL termination.
The core feature is real-time inbound mail delivery: when an email arrives at your domain's MX records, it is processed immediately by the Worker without polling or queuing. This eliminates latency associated with traditional IMAP/POP3 clients and provides instant access to new messages. The system supports multiple domains per instance through a catch-all routing mechanism, allowing users to create arbitrary addresses while maintaining a single deployment.
Email delivery is handled via Resend API for outbound sending and Cloudflare Email Service for inbound webhook processing. Both providers deliver events such as delivered, bounced, complained, and delivery delay status back to the Worker, enabling full tracking of mail lifecycle. The system supports attachment handling through R2 object storage for incoming files and file upload from email clients for outgoing messages.
The architecture includes REST API endpoints for programmatic access, a CLI tool, and an MCP (Model Context Protocol) server that allows AI agents like Cursor or Claude to interact with the inbox directly. Inbox tabs provide Gmail-style classification of mail into categories such as Primary, Social, Promotions, Updates, and Forums, with spam detection using configurable confidence thresholds.
The application supports multiple user accounts per instance through a centralized admin dashboard, each with their own session management. Notifications can be delivered via desktop push notifications or Telegram bots for users who prefer mobile-first access without installing additional software.
- Self-hosted email client for small to medium businesses requiring full control over data and infrastructure
- Email forwarding and relay setup where third-party providers are unavailable or too expensive
- Development environments needing a local mail client with API access for automation scripts
- AI agent integration using MCP server to programmatically send, read, and classify emails
- Multi-user shared email accounts in organizations without dedicated mail servers
- Domain-specific communication tools where users need per-domain address management
- Runs entirely on Cloudflare Workers with no additional infrastructure costs beyond the paid plan
- Real-time inbound delivery with zero polling latency, eliminating IMAP/POP3 overhead
- Supports unlimited number of user accounts and domains per single deployment instance
- MCP server enables direct AI agent integration for programmatic email operations
- Inbox tabs provide Gmail-style classification into categories like Primary, Social, Promotions, Updates, and Forums
- Attachment handling with R2 storage for incoming files and file upload from email clients
- Requires a paid Cloudflare Workers plan to enable inbound email processing via webhook handlers
- Cloudflare Email Service requires DNS configuration on the domain side, which may not be available in all hosting environments
- Telegram notifications require a valid Telegram Bot Token and Chat ID, with thread-specific routing requiring additional configuration
- Inbox tabs require a Typesafe API key to enable classification features, adding an extra authentication step
- Delivery status tracking is limited to provider-supported events (delivered, bounced, complained) rather than providing full SMTP-level control
- The CLI tool requires Wrangler 4.123+ and may not work with older versions of the Cloudflare SDK
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Quickinbox deploys as a single Worker application using Bun for development and production builds. The deployment process involves creating D1 databases, R2 buckets for attachments, configuring Wrangler secrets (API keys), and deploying via `bun run deploy`. For inbound email processing, the Cloudflare Email Service must be enabled on your domain's DNS zone before the Worker can receive webhook events. The app supports both Resend API and Cloudflare Email Service as providers; choose based on whether you need custom outbound sending or prefer the built-in Workers email handler. Always verify that your domain's MX records point to the correct provider — misconfiguration will result in mail not being delivered. For production, use `bun run preview` for testing inbound delivery before deploying to production. The app supports multiple accounts per instance via a centralized admin dashboard
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.