create-email-agent

Set up your own AI email agent with Claude Code in 5 minutes.

What you get

An AI alter ego that reads your Gmail, understands your context, and can respond to emails on your behalf. It asks before sending unless you tell it to be autonomous.

Prerequisites

• Claude Code (requires Claude Max subscription, $100/mo)
• A Gmail account with 2-factor auth enabled
• Node.js 18+ and git

Setup

npx create-email-agent

The wizard will:

1. Check your prerequisites
2. Ask for your Gmail address and App Password
3. Ask for your AI agent's name and your context
4. Install and build the Gmail MCP server locally
5. Configure Claude Code to use it
6. Generate a CLAUDE.md template for your AI's context

After setup:

1. Restart Claude Code (so it loads the new Gmail server)
2. Edit CLAUDE.md — fill in the context sections about you, your team, your projects
3. Open Claude Code and say: "Check my inbox and tell me what needs attention"

Getting a Gmail App Password

1. Go to https://myaccount.google.com/apppasswords
2. You may need to enable 2-factor auth first
3. Create a new app password for "Mail"
4. Copy the 16-character password (looks like xxxx xxxx xxxx xxxx)

How it works

• Gmail MCP server runs locally on your machine — your credentials never leave your computer
• CLAUDE.md is your AI's brain — the more context you give it, the better it performs
• Default mode is supervised — it shows you drafts before sending
• Say "be autonomous" in a session to let it send without asking

Upgrading

This gives you Tier 1 — a personal email assistant. For persistent memory across sessions or multi-project orchestration, see the full guide.

License

MIT