Repository navigation
v3.4.2
gomailtesttool Suite - Email Infrastructure Testing Tools
Portable CLI tools for comprehensive email infrastructure testing - covering cloud services (Exchange Online via Microsoft Graph), SMTP, IMAP, POP3, and JMAP protocols.
What's Included
Each ZIP archive contains a single unified binary:
- gomailtest - Unified CLI for all protocols (smtp, imap, pop3, jmap, msgraph subcommands)
Plus documentation:
- README.md - Main documentation
- TOOLS.md - Protocol-specific tool guides
- LICENSE - MIT License
Installation
Windows (amd64):
- Download
gomailtesttool-windows-amd64-v3.4.2.zip - Extract the ZIP file
- Run:
gomailtest.exe --help
Linux (amd64):
- Download
gomailtesttool-linux-amd64-v3.4.2.zip - Extract:
unzip gomailtesttool-linux-amd64-v3.4.2.zip - Make executable:
chmod +x gomailtest - Run:
./gomailtest --help
macOS (Apple Silicon/arm64):
- Download
gomailtesttool-macos-arm64-v3.4.2.zip - Extract:
unzip gomailtesttool-macos-arm64-v3.4.2.zip - Make executable:
chmod +x gomailtest - Run:
./gomailtest --help
Note for macOS: If you see "cannot be opened because the developer cannot be verified":
- Right-click the binary and select "Open", or
- Run:
xattr -d com.apple.quarantine gomailtest
Quick Start Examples
SMTP Testing:
# Test connectivity
./gomailtest smtp testconnect -host smtp.example.com -port 25
# TLS diagnostics
./gomailtest smtp teststarttls -host smtp.example.com -port 587IMAP Testing:
# Test connection
./gomailtest imap testconnect -host imap.gmail.com -imaps
# List folders with OAuth2
./gomailtest imap listfolders -host imap.gmail.com -imaps \
-username user@gmail.com -accesstoken "ya29..."POP3 Testing:
# Test connection
./gomailtest pop3 testconnect -host pop.gmail.com -pop3s
# List mail
./gomailtest pop3 listmail -host pop.gmail.com -pop3s \
-username user@gmail.com -password "app-password"JMAP Testing:
# Discover session
./gomailtest jmap testconnect -host jmap.fastmail.com
# Get mailboxes
./gomailtest jmap getmailboxes -host jmap.fastmail.com \
-username user@fastmail.com -accesstoken "token"Microsoft Graph:
./gomailtest msgraph -tenantid "..." -clientid "..." -secret "..." \
-mailbox "user@example.com" -action getinboxDocumentation
- Online: GitHub Repository