v0.1 MIT · self-hosted · zero-dep
Give your agents an inbox.
Open-source email infrastructure for AI agents. Send, receive, search, and parse — self-hosted on Cloudflare.
$
npx @messo/cli setup scroll
✦SELF-HOSTED✦8.8KB SDK✦11.9KB CLI✦ZERO DEPS✦CLOUDFLARE WORKERS✦D1 STORAGE✦AI-NATIVE TOOLS✦MIT LICENSE✦SELF-HOSTED✦8.8KB SDK✦11.9KB CLI✦ZERO DEPS✦CLOUDFLARE WORKERS✦D1 STORAGE✦AI-NATIVE TOOLS✦MIT LICENSE
// how it works
Agents send. Agents receive.
$ npx @messo/cli setup
✓ Worker deployed
✓ D1 database created
✓ API key generated
Ready in 12s
$ npx @messo/cli claim support-bot
→ support-bot@yourdomain.com
$ npx @messo/cli inbox
→ [GitHub] Your verification code is 847293
→ [Stripe] Payment receipt — $29.00
$ npx @messo/cli search "verification code"
→ Found: 847293 (from GitHub, 2m ago)
// features
Built for agents, not humans.
00
Self-hosted. Your data never leaves your account.
Runs entirely on your Cloudflare account — Workers + D1. No SaaS middleman, no API keys shared with a third party. Your agents' mail stays yours.
01
Structured Parsing
Intent detection, link extraction, action items — pure heuristics, no LLM call needed.
02
Multi-Mailbox
One inbox per agent. Claim, manage, and route independently — no shared state.
03
AI-Native Tools
Pre-built tool definitions for Vercel AI SDK and LangChain. Drop into any agent.
04
Zero Dependencies
SDK is 8.8KB, CLI is 11.9KB. Pure stdlib, no bloat — install and forget.
// quickstart
Everything in one import.
import { messo, parseEmail } from "@messo/cli"; const m = messo({ apiUrl: "https://messo.your-domain.workers.dev" }); // Claim a mailbox for your agent const box = await m.claim({ agent_name: "support-bot" }); // Check inbox & parse in one step const { emails } = await m.inbox(box.id); const parsed = parseEmail(await m.getEmail(emails[0].id)); // → { intent: "password_reset", links: [...], actionItems: [...] } // Pre-built tool defs for Vercel AI SDK & LangChain const tools = m.tools(); // check_inbox · read_email · search_inbox · send_email
# Install npm install @messo/cli # Deploy to your Cloudflare account npx @messo/cli setup ✓ Worker deployed ✓ D1 database created ✓ API key generated Ready in 12s # Claim a mailbox npx @messo/cli claim support-bot → support-bot@yourdomain.com # Check inbox npx @messo/cli inbox → [GitHub] Your verification code is 847293 → [Stripe] Payment receipt — $29.00
Your agents deserve
real mail.
MIT licensed. No signup. No SaaS. Just npx.