# inbox-zero

> MCP Server

Inbox Zero is an open-source AI email assistant and client designed to help users achieve inbox zero quickly. It offers features like AI-powered email management, reply tracking, smart categories, and

## Overview

- **Category:** Productivity
- **Language:** TypeScript
- **Stars:** 12002
- **Forks:** 410
- **Owner:** elie222
- **GitHub:** https://github.com/elie222/inbox-zero
- **Homepage:** https://getinboxzero.com
- **Created:** 2023-07-12T15:34:57+00:00
- **Updated:** 2025-03-28T21:40:32+00:00
- **Source:** https://model-context-protocol.com/servers/open-source-ai-email-inbox-zero

## Setup

## Setup

1.  Ensure you have the following requirements:
    *   [Node.js](https://nodejs.org/en/) >= 18.0.0
    *   [pnpm](https://pnpm.io/) >= 8.6.12
    *   [Docker desktop](https://www.docker.com/products/docker-desktop/) (optional)
2.  Set up the required external services:
    *   [Google OAuth](https://console.cloud.google.com/apis/credentials)
    *   [Google PubSub](https://console.cloud.google.com/cloudpubsub/topic/list)
    *   LLM (Anthropic, OpenAI, AWS Bedrock Anthropic, Google Gemini, Groq Llama 3.3 70B, or Ollama)
3.  Set up Postgres for the database and Redis (Upstash Redis or your own instance).
4.  Run Postgres & Redis locally using `docker-compose up -d` (optional).
5.  Create a `.env` file by copying `apps/web/.env.example` to `apps/web/.env`.
6.  Navigate to the `apps/web` directory and run `pnpm install`.
7.  Set the environment variables in the `.env` file, referring to `apps/web/env.ts` for required variables.
8.  Required environment variables include:
    *   `NEXTAUTH_SECRET`
    *   `GOOGLE_CLIENT_ID`
    *   `GOOGLE_CLIENT_SECRET`
    *   `GOOGLE_ENCRYPT_SECRET`
    *   `GOOGLE_ENCRYPT_SALT`
    *   `UPSTASH_REDIS_URL`
    *   `UPSTASH_REDIS_TOKEN`
9.  When using Vercel with Fluid Compute turned off, set `MAX_DURATION=300` or lower.
10. Run the migrations using `pnpm prisma migrate dev`.
11. Run the app locally using `pnpm run dev` or `turbo dev` from the project root.
12. Open [http://localhost:3000](http://localhost:3000) in your browser.
13. To upgrade yourself to admin visit: [http://localhost:3000/admin].
14. For Ollama, set `OLLAMA_BASE_URL` and `NEXT_PUBLIC_OLLAMA_MODEL` environment variables.
15. Enable the specified scopes in the Google Cloud Console for Google OAuth and Gmail API.
16. Set up push notifications via Google PubSub following the provided instructions, including creating a topic and subscription, and granting publish rights.
17. Set the `GOOGLE_PUBSUB_TOPIC_NAME` environment variable.
18. Set `GOOGLE_PUBSUB_VERIFICATION_TOKEN` in your `.env` file.
19. Use ngrok for development if needed, and update the webhook endpoint in the Google PubSub subscriptions dashboard.
20. Start watching emails by visiting `/api/google/watch/all`.
21. Set cron jobs for `/api/google/watch/all` and `/api/resend/summary/all`.

## Tools

## Available Tools

1.  **AI Personal Assistant:** Manages your email based on a plain text prompt file, taking actions like drafting replies, labeling, archiving, replying, forwarding, marking spam, and calling webhooks.
2.  **Reply Zero:** Tracks emails that need your reply and those awaiting responses.
3.  **Smart Categories:** Categorizes everyone that's ever emailed you.
4.  **Bulk Unsubscriber:** Quickly unsubscribe from emails you never read in one-click.
5.  **Cold Email Blocker:** Automatically block cold emails.
6.  **Email Analytics:** Track your email activity with daily, weekly, and monthly stats.