agent-mail

Configure a private maddy mail server on Linux hosts with self-signed TLS.

Updated May 13, 2026
One-click install
npx skills add https://github.com/ohnotnow/agent-local-mail --skill agent-mail-ohnotnow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-mail
Source: https://github.com/ohnotnow/agent-local-mail/tree/main
Command: npx skills add https://github.com/ohnotnow/agent-local-mail --skill agent-mail-ohnotnow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the challenge of enabling local AI agents to communicate via email without relying on public internet services, complex MX records, or privacy-invasive third-party providers.

Core Features & Use Cases

  • LAN-Only Mail Infrastructure: Installs and configures a maddy mail server on Linux hosts to facilitate internal communication between agents and users.
  • Secure Local Delivery: Supports self-signed TLS for encrypted communication between local mail clients and agents like Hermes.
  • Use Case: Perfect for setting up a private communication channel where a local agent can send status updates or notifications directly to your Apple Mail or Thunderbird client over your home network.

Quick Start

Ask the agent to set up a local mail server on the target host using the specified domain and state directory.

Frequently Asked Questions about agent-mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a private mail server for local AI agents on my LAN?

To set up a private mail server for local AI agents, this skill configures a maddy mail server on Linux hosts to enable secure, internet-free email communication between local network agents and user mail clients.

What prerequisites do I need to configure a LAN-only maddy mail server?

Configuring a LAN-only maddy mail server requires SSH access to a Debian or Ubuntu-based host with systemd and standard shell utilities to successfully install the private agent communication infrastructure.

Does the self-hosted mail server support encryption for local agent communication?

Yes, the self-hosted mail server supports self-signed TLS encryption, ensuring secure local delivery and encrypted communication between local mail clients and agents over your private network.

Can I use this private mail server with standard clients like Apple Mail or Thunderbird?

Yes, you can use this private mail server with standard clients like Apple Mail or Thunderbird to receive status updates or notifications directly from local AI agents over your home network.

Do I need public MX records or internet access to run a self-hosted mail server for agents?

No, you do not need public MX records or internet access to run this self-hosted mail server, as it is designed specifically for LAN-only delivery without relying on public internet services.

Does the local mail server support multi-user mailbox creation for different agents?

Yes, the local mail server supports multi-user mailbox creation, allowing you to create separate mailboxes for different local AI agents and users within your private LAN infrastructure.