chekusu

chekusu / mails

Public

email for agents. Built for AI agents that need to send, receive, and understand emails programmatically

mails.dev agent cli mail
84
6
100% credibility
Found Mar 19, 2026 at 85 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

mails is an email toolkit for AI agents that enables simple sending, receiving, searching, and code extraction via commands or code, with free hosted mailboxes or self-hosted options.

How It Works

1
🔍 Discover mails

You learn about a handy tool that lets your AI assistant send and receive real emails just like a person.

2
📥 Add the tool

You easily put the mails tool on your computer so it's ready to use anytime.

3
🏷️ Get your agent's email

You pick a fun name like myagent and claim your own free email address ending in @mails.dev.

4
Choose your setup
☁️
Use the easy free plan

Jump right in with the hosted service that gives you 100 free emails a month and handles everything.

🏠
Build your own

Connect it to your own email address for complete control and no limits.

5
📤 Send your first email

You tell it who to email, what to say, and even add files, and it sends perfectly.

6
📬 Check incoming mail

You peek at your inbox, search for words like 'code', or wait for special numbers from replies.

🎉 AI emails unlocked

Now your AI helper can chat via email, grab codes, and handle attachments effortlessly!

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 85 to 84 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is mails?

mails gives AI agents disposable email addresses like agent@mails.dev for sending, receiving, and parsing emails programmatically. Developers use its TypeScript CLI or SDK to claim free hosted mailboxes (100 sends/month), search inboxes by keyword, extract verification codes in English/Chinese/Japanese/Korean, and handle attachments—all via Resend for outbound and Cloudflare Workers for inbound. It solves the hassle of email setup for agents email address needs, with storage in local SQLite, db9.ai Postgres, or remote APIs.

Why is it gaining traction?

Zero-config hosted mode skips API keys for quick starts, while self-hosting offers full control without vendor lock-in. Standout hooks include auto code extraction for auth flows (mails code --to agent@mails.dev), full-text inbox search (mails inbox --query "password"), and attachment support in both CLI (--attach file.pdf) and SDK. For ai agents for email on GitHub, it's lighter than full mailserver stacks, with multilingual parsing that just works.

Who should use this?

AI agent builders integrating email for user signups, OTPs, or notifications—like copilot email agents or email agents github bots scraping github email notifications. Ideal for TypeScript devs prototyping autonomous agents needing email github user interactions or estate agents email addresses without managing SMTP/IMAP servers.

Verdict

Grab it for agent prototypes if you're okay with early maturity—84 stars and 1.0% credibility score reflect its niche youth, but 125 unit + 42 E2E tests, multilingual docs, and MIT license make it reliable enough to try. Self-host for production; hosted for hacks.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.