This repository provides a demo application showcasing the Claude Code SDK for building an AI-powered email assistant. Targeted at developers interested in integrating large language models with email workflows, it offers features like natural language search and AI-assisted email drafting, demonstrating practical applications of the SDK.

How It Works

The email agent leverages the Claude Code SDK to interact with an IMAP-enabled email account. It processes emails using Claude for natural language understanding, enabling features such as conversational search queries and AI-driven response drafting. Local caching and search are facilitated by SQLite integration, while a WebSocket-based backend provides real-time UI updates for a dynamic user experience.

Quick Start & Requirements

1. Install: Clone the repository and navigate to the email-agent directory. Install dependencies using bun install or npm install.
2. Configure: Copy .env.example to .env and populate it with your Anthropic API key, email credentials (including an IMAP host/port), and a Gmail App Password if using Gmail.
3. Run: Execute bun run dev or npm run dev.
4. Access: Open http://localhost:3000 in your browser.

Prerequisites: Bun runtime (or Node.js 18+), an Anthropic API key, and an email account with IMAP access enabled. Gmail users require 2-Factor Authentication and an App Password.

Highlighted Details

• Natural Language Search: Find emails using conversational queries.
• AI-Powered Assistance: Claude assists in drafting replies, summarizing threads, and extracting information.
• SQLite Integration: Enables fast local email caching and search capabilities.
• Real-time Streaming: Features WebSocket-based UI updates for dynamic interaction.
• Multi-turn Conversations: Supports complex email workflows with context retention.

Maintenance & Community

This is a demo application provided by Anthropic. For issues related to the Claude Code SDK, refer to the SDK Documentation. Demo-specific issues should be reported via GitHub Issues, and API questions can be directed to Anthropic Support.

Licensing & Compatibility

The project is licensed under the MIT License, indicating it is sample code for demonstration purposes.

Limitations & Caveats

This application is intended for local development only and is not designed for production deployment or scaled use. It stores email credentials in plain text environment variables, lacks authentication, and does not meet production security standards.