by agentteamhq
Open-source email infrastructure for AI agents.
# Add to your Claude Code skills
git clone https://github.com/agentteamhq/agentteam-emailGuides for using ai agents skills like agentteam-email.
agentteam-email is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by agentteamhq. Open-source email infrastructure for AI agents. It has 175 GitHub stars.
agentteam-email's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/agentteamhq/agentteam-email" and add it to your Claude Code skills directory (see the Installation section above).
agentteam-email is primarily written in TypeScript. It is open-source under agentteamhq on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh agentteam-email against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
at-email CLI and agent skill for operating authorized mailboxes.AgentTeam Email has one public boundary: the web server in apps/web-server.
Browsers, API clients, CLI clients, and agent tools authenticate there. Internal
mail services stay behind the deployment network.
Inbound mail follows this path:
Cloudflare Email Routing -> Email Worker -> R2 archive -> web ingest -> mail control -> Haraka/WildDuck -> mailbox
Outbound mail follows this path:
agent or user -> web server -> WildDuck -> ZoneMTA -> mail control relay -> outbound provider or local domain
See ARCHITECTURE.md for the full architecture contract and Mail Flow for the message-flow guide.
Start with the Quickstart to choose a runtime, prepare the admin instance, expose the web server, provision the first domain, and validate mail delivery.
Main setup docs:
AgentTeam Email runs the same service graph through Compose or Helm:
compose.yaml for a single-host deployment.charts/agentteam-email for Kubernetes deployments.Compose users configure the environment from the published example:
cp docs/examples/compose/.env.example .env
docker compose up -d
docker compose ps
Helm users install the chart from GHCR:
helm upgrade --install atemail \
oci://ghcr.io/agentteamhq/agentteam-email \
--namespace agentteam-email \
--create-namespace \
-f values.yaml
Only the web server should be public. WildDuck, Haraka, ZoneMTA, Rspamd, MongoDB, Redis, and the Mail Control Service must remain internal.
The at-email CLI lets agents and operators use authorized mailboxes through
the AgentTeam Email web server. Public clients must not call WildDuck or the
Mail Control Service directly.
Check local availability:
command -v at-email
at-email --version
One-off npm usage:
npx --yes @agentteamhq/email@latest --version
Agent setup paths:
at-email agent connect
at-email agent trial
at-email agent enroll TOKEN
The canonical skill lives in skills/at-email-cli. Publishing and marketplace notes live in SKILL-PUBLISHING.md.
Install repo-managed tools from the repository root:
mise install
pnpm install
Common checks:
pnpm typecheck
pnpm lint
mise run test
Run source-development services and the local app graph through repo-owned tasks:
mise run db:start
mise run mail:start
mise run dev
For worktree identity, local runtime, image builds, and validation command selection, read SETUP.md.
apps/web-server: public web server and deployable Node entrypoint.apps/mail-control-service: internal mail runtime coordination service.apps/at-email-cli: portable CLI distribution.packages/frontend: authenticated product UI and Storybook surface.packages/backend: backend APIs, auth, and service integration logic.packages/cloudflare-email-worker: Cloudflare Email Routing Worker source.charts/agentteam-email: Helm chart for Kubernetes installs.docs: Mintlify documentation source.skills/at-email-cli: agent skill source for CLI mailbox operation.Read SECURITY.md before changing authentication, authorization, credentials, encryption, sessions, cookies, API keys, tokens, OAuth, JWKS, or other security-sensitive behavior.
AgentTeam Email keeps public and internal boundaries separate:
Report vulnerabilities through the private process in SECURITY.md.
See CONTRIBUTING.md for local setup, validation, pull request guidance, and public issue expectations. Do not include secrets, private hostnames, credentials, tokens, or private operational details in issues, pull requests, docs, examples, or logs.
MIT. See LICENSE.