Inbox-as-a-Service for AI Agents
Open-source, self-hosted API that turns standard email providers into intelligent, stateful email for LLMs via REST or MCP.
"Thaer log logdu, thaer lif voldu..."
"Laws they made there, and life allotted / To the sons of men, and set their fates."
— Voluspa (The Prophecy of the Seeress), Poetic Edda, Stanza 20
Image: "Nornorna spinner odets tradar vid Yggdrasil" by L. B. Hansen — Public Domain
Features
Virtual Inboxes
Create dedicated email addresses for your AI agents. Each inbox can receive and send emails independently.
Webhook Ingestion
Receive emails from Mailgun, AWS SES, SendGrid, and Resend through webhook endpoints.
Smart Threading
Automatic conversation grouping using email headers. Messages are organized into threads.
REST API
Full REST API for inbox, thread, and message management. LLM-optimized response formats.
MCP Integration
Connect directly to Claude, Cursor, and other MCP clients. Read and send email with natural language.
Clean Architecture
Thematic components inspired by Norse mythology. Modular design with storage and provider adapters.
Current Capabilities
Phase 1: Foundation
The Mail Proxy — Virtual Inboxes for AI agents, webhook ingestion from providers, PostgreSQL persistent storage, email sending via configured provider, and API key authentication.
Phase 2: Intelligence
The Agent Layer — HTML to clean Markdown parsing, automatic cruft removal, smart conversation threading, MCP server for Claude/Cursor, and attachment text extraction.
Quick Start
# Clone the repository
git clone https://github.com/DataCovey/nornweave.git
cd nornweave
# Copy environment configuration
cp .env.example .env
# Edit .env with your API keys
# Start the stack
docker compose up -d
# Run migrations
docker compose exec api alembic upgrade head