~/web4w3›email-review-agentAgent
email-review-agent — README.md
❯cat README.md

# Email Review Agent

An interactive agent that reviews your emails from Gmail or Outlook using OpenAI. Connects to email MCP servers and lets you review, categorize, and act on your inbox with AI assistance through a conversational CLI.

❯cat email-review-agent/ARCHITECTURE.md

## How It Works

The agent launches your email MCP server as a child process, then enters an interactive CLI loop. You select an email provider (Gmail or Outlook), and the agent fetches recent emails and streams them to OpenAI for review. OpenAI summarises, flags action items, and suggests a response — all in your terminal.

Email Review Agent (CLI)
    └── Spawns email MCP server (Gmail or Outlook)
    └── Fetches emails via MCP tools
    └── Streams to OpenAI Chat API
    └── Presents summary + action items
    └── Interactive: mark read, reply, skip
❯email-review-agent --demo

## Screenshots

email-review — provider selection
❯  node dist/agent.js

   Which email provider?
   ▶  Gmail
      Outlook

   Connecting to Gmail MCP...  ✓
   Fetching recent emails...   ✓  34 messages
email-review — AI review
   ── Email 1/34 ─────────────────────────────────
   From: sarah@design.co
   Subject: Q3 dashboard mockups — your feedback?

   AI Summary:
   Sarah sent Figma mockups for the Q3 dashboard.
   She needs your feedback by Friday (Jun 20).
   Action: Review link and reply with comments.

   [r] Reply  [d] Delete  [s] Skip  [q] Quit
❯grep -n "## Features" email-review-agent/README.md

## Features

  • +Gmail and Outlook support
  • +OpenAI-powered review
  • +Interactive CLI workflow
  • +MCP server integration
❯email-review-agent --compare

## vs. The Field

FeatureEmail Review AgentGmail Smart LabelsSuperhuman
AI review per email✓partial✓
Multi-provider support✓✗paid
MCP integration✓✗✗
Free / open source✓✓✗
Custom review criteria✓✗partial
❯cd email-review-agent && cat INSTALL.md

## Installation

1

Set up an email MCP server

Gmail or Outlook MCP must be installed and configured first.

⚠ See the Gmail MCP Server or Outlook MCP Server pages in this ecosystem.

2

Set your OpenAI API key

export OPENAI_API_KEY=sk-...
3

Install the agent

npm install
npm run build
4

Run

Select your provider and start reviewing.

node dist/agent.js
❯cat email-review-agent/package.json | jq '.dependencies | keys'

## Tech Stack

Node.jsTypeScriptOpenAI SDKMCP SDK
←Email Analytics↑ all packagesGmail MCP Server→