whatisgithub

What is agentic-inbox?

cloudflare/agentic-inbox — explained in plain English

Analysis updated 2026-05-18

3,029TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

A self hosted email client with a built in AI agent that reads, drafts, and sends replies, running fully on Cloudflare Workers.

Mindmap

mindmap
  root((Agentic Inbox))
    What it does
      Send and receive email
      AI drafts replies
      Self hosted
    Tech stack
      Cloudflare Workers
      Durable Objects
      React
      Hono
    Use cases
      Personal email client
      Domain email hosting
      Agent assisted replies
    Setup
      Deploy to Cloudflare
      Configure Access
      Set up Email Routing

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run your own private email client for a custom domain without relying on a third party inbox provider.

USE CASE 2

Let an AI agent draft replies to incoming email automatically, with you approving before anything sends.

USE CASE 3

Search and manage email conversations through a chat style agent panel alongside the normal inbox view.

What is it built with?

TypeScriptReactHonoCloudflare WorkersDurable Objects

How does it compare?

cloudflare/agentic-inboxneilsonnn/image-blasternutlope/self.so
Stars3,0293,0642,980
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardmoderate
Complexity4/54/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a Cloudflare account, a domain, Email Routing, Workers AI, and Cloudflare Access configuration before use.

Apache 2.0: free to use, modify, and distribute, including commercially, as long as you keep the license and copyright notice.

So what is it?

Agentic Inbox is a self hosted email client that runs entirely on Cloudflare Workers and includes a built in AI agent. It lets you send, receive, and manage email through a modern web interface, using your own Cloudflare account rather than a third party email provider. Incoming email arrives through Cloudflare Email Routing. Each mailbox is isolated in its own Durable Object with its own SQLite database, and attachments are stored in Cloudflare R2. On top of this, an AI powered Email Agent can read your inbox, search past conversations, and draft replies. When a new email arrives, the agent automatically reads it and generates a draft reply, but it always requires your explicit confirmation before actually sending anything. The full email client includes a rich text composer, reply and forward threading, folder organization, search, and attachment support. The agent side panel offers nine email tools for reading, searching, drafting, and sending, along with persistent chat history, streaming responses, and visibility into which tools the agent is calling. Setting it up involves more than clicking the Deploy to Cloudflare button. You also need to configure Cloudflare Access to protect the deployed app, set up Email Routing so your domain forwards mail to the Worker, and enable the Email Service and Workers AI features on your account. The README is explicit that Cloudflare Access is required in production: without it, your inbox would be reachable by anyone who finds the URL, and any user who passes the Access policy can see every mailbox in the deployment, since there is no separate per mailbox authorization. Under the hood it is built with React, React Router, Tailwind CSS, and TipTap on the frontend, and Hono running on Cloudflare Workers with Durable Objects, R2, and Email Routing on the backend. The AI agent layer uses the Cloudflare Agents SDK together with Workers AI. It requires a Cloudflare account with a domain, plus Email Routing, Email Service, and Workers AI enabled, and it is released under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
Walk me through deploying Agentic Inbox to my Cloudflare account and setting up Email Routing.
Prompt 2
Help me configure Cloudflare Access with the correct POLICY_AUD and TEAM_DOMAIN secrets for this Worker.
Prompt 3
Explain how mailbox isolation works with Durable Objects in Agentic Inbox.
Prompt 4
What do I need to set up before the AI email agent can draft replies for me?

Frequently asked questions

What is agentic-inbox?

A self hosted email client with a built in AI agent that reads, drafts, and sends replies, running fully on Cloudflare Workers.

What language is agentic-inbox written in?

Mainly TypeScript. The stack also includes TypeScript, React, Hono.

What license does agentic-inbox use?

Apache 2.0: free to use, modify, and distribute, including commercially, as long as you keep the license and copyright notice.

How hard is agentic-inbox to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is agentic-inbox for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.