agentic-inbox  by cloudflare

Self-hosted email client with AI agent

Created 1 week ago

New!

1,118 stars

Top 34.0% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

A self-hosted email client with an integrated AI agent, Agentic Inbox runs entirely on Cloudflare Workers. It targets users seeking a modern, secure, and intelligent email management solution within their Cloudflare ecosystem, offering a robust alternative to traditional clients by leveraging serverless architecture.

How It Works

The project utilizes Cloudflare Workers as its backend, with each mailbox isolated in its own Durable Object backed by SQLite for data and R2 for attachments. Incoming emails are managed via Cloudflare Email Routing. An AI agent, built using the Cloudflare Agents SDK and Workers AI, provides capabilities for reading, searching, and drafting email responses, integrated directly into the client's interface. This approach offers a scalable, cost-effective, and highly integrated solution within Cloudflare's platform.

Quick Start & Requirements

  • Primary install/run command: npm install, npm run dev (local), npm run deploy (Cloudflare).
  • Non-default prerequisites: Cloudflare account, a registered domain, Cloudflare Email Routing enabled (for receiving), Cloudflare Email Service enabled (for sending), Workers AI enabled, and Cloudflare Access configured for deployed environments.
  • Setup: Deployment involves clicking "Deploy to Cloudflare" followed by manual configuration of domain settings, Cloudflare Access secrets (POLICY_AUD, TEAM_DOMAIN), Email Routing rules, and enabling Email Service. A detailed setup guide is available via a GitHub issue comment.
  • Links: Blog post: Email for Agents. Setup guide: https://github.com/cloudflare/agentic-inbox/issues/4#issuecomment-4269118513.

Highlighted Details

  • Full-featured email client: supports sending, receiving, rich text composition, threading, folder organization, search, and attachments.
  • Per-mailbox isolation: Each mailbox is a distinct Durable Object with its own SQLite database and R2 storage.
  • Integrated AI agent: Offers 9 email-specific tools for tasks like reading, searching, and drafting replies, with auto-drafting capabilities on new inbound emails.
  • Configurable AI experience: Supports custom system prompts per mailbox, persistent chat history, and streaming markdown responses.

Maintenance & Community

No specific details regarding notable contributors, sponsorships, community channels (e.g., Discord, Slack), or a public roadmap are provided in the README.

Licensing & Compatibility

  • License type: Apache 2.0.
  • Compatibility notes: Cloudflare Access is mandatory for deployed instances, serving as the sole authorization layer. Any user authenticated via the configured Cloudflare Access policy can access all mailboxes within the application.

Limitations & Caveats

The application lacks per-mailbox authorization; access control is solely managed by the overarching Cloudflare Access policy, meaning all mailboxes are accessible to any user who passes this policy.

Health Check
Last Commit

4 days ago

Responsiveness

Inactive

Pull Requests (30d)
5
Issues (30d)
5
Star History
1,136 stars in the last 12 days

Explore Similar Projects

Feedback? Help us improve.