elie222/inbox-zero

Mission

To help you spend less time in your inbox, so you can focus on what matters most.

Features

• AI Personal Assistant: Organizes your inbox and pre-drafts replies in your tone and style.
• Cursor Rules for email: Explain in plain English how your AI should handle your inbox.
• Reply Zero: Track emails to reply to and those awaiting responses.
• Bulk Unsubscriber: One-click unsubscribe and archive emails you never read.
• Bulk Archiver: Clean up your inbox by bulk archiving old emails.
• Cold Email Blocker: Auto‑block cold emails.
• Email Analytics: Track your activity and trends over time.
• Meeting Briefs: Get personalized briefings before every meeting, pulling context from your email and calendar.
• Smart Filing: Automatically save email attachments to Google Drive or OneDrive.
• Slack & Telegram Integration: Chat with your AI assistant from Slack or Telegram to manage your inbox without leaving the apps you already use.

Learn more in our docs.

Cursor plugin (API CLI)

This repo is packaged as a Cursor plugin (.cursor-plugin/plugin.json): install from the directory to use the inbox-zero-api skill and agent. Skill source lives in clawhub/inbox-zero-api (same as OpenClaw); skills/inbox-zero-api is a symlink for discovery. Requires @inbox-zero/api; set INBOX_ZERO_API_KEY for authenticated CLI commands (e.g. rules, stats). openapi --json does not need a key.

Feature Screenshots

AI Assistant	Reply Zero
Gmail client	Bulk Unsubscriber

Demo Video

Built with

• Next.js
• Tailwind CSS
• shadcn/ui
• Prisma
• Upstash
• Turborepo
• Popsy Illustrations

Star History

Feature Requests

To request a feature open a GitHub issue, or join our Discord.

Getting Started

We offer a hosted version of Inbox Zero at getinboxzero.com.

Self-Hosting

The fastest way to self-host Inbox Zero is with the CLI:

Prerequisites: Docker and Node.js v24+

npx @inbox-zero/cli setup      # One-time setup wizard
npx @inbox-zero/cli start      # Start containers

Open http://localhost:3000

For complete self-hosting instructions, production deployment, OAuth setup, and configuration options, see our Self-Hosting Docs.

Local Development

Prerequisites: Docker, Node.js v24+, and pnpm v10+

git clone https://github.com/elie222/inbox-zero.git
cd inbox-zero
docker compose -f docker-compose.dev.yml up -d   # Postgres + Redis
pnpm install
npm run setup                                     # Interactive env setup
cd apps/web && pnpm prisma migrate dev && cd ../..
pnpm dev

Open http://localhost:3000

After pnpm install, if you want to use the local Google emulator, start it with:

docker compose -f docker-compose.dev.yml --profile google-emulator up -d

Then point apps/web/.env at it with:

GOOGLE_BASE_URL=http://localhost:4002
GOOGLE_CLIENT_ID=emulate-google-client.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=emulate-google-secret

If you want to use the local Microsoft emulator, start it with:

docker compose -f docker-compose.dev.yml --profile microsoft-emulator up -d

Then point apps/web/.env at it with:

MICROSOFT_BASE_URL=http://localhost:4003
MICROSOFT_CLIENT_ID=emulate-microsoft-client-id
MICROSOFT_CLIENT_SECRET=emulate-microsoft-secret

See the Contributing Guide for more details including devcontainer setup.

Contributing

View open tasks in GitHub Issues and join our Discord to discuss what's being worked on.

Docker images are automatically built on every push to main and tagged with the commit SHA (e.g., elie222/inbox-zero:abc1234). The latest tag always points to the most recent main build. Formal releases use version tags (e.g., v2.26.0).