Repository navigation
v4.1.4
gomailtesttool Suite v4.0 - Email Infrastructure Testing Tools
Portable CLI tools for comprehensive email infrastructure testing, now split into focused binaries.
What's Included
Each ZIP archive contains three separate binaries:
- gomailtest - Standard protocols (smtp, imap, pop3, jmap)
- gomailtest-exchange - Microsoft/Exchange protocols (ews, msgraph)
- gomailtest-gmail - Gmail / Google Workspace
Plus documentation:
- README.md - Main documentation
- TOOLS.md - Protocol-specific tool guides
- LICENSE - MIT License
Installation
Windows (amd64):
- Download
gomailtesttool-windows-amd64-v4.1.4.zip - Extract the ZIP file
- Run e.g.:
gomailtest.exe --help
Linux (amd64):
- Download
gomailtesttool-linux-amd64-v4.1.4.zip - Extract:
unzip gomailtesttool-linux-amd64-v4.1.4.zip - Make executables:
chmod +x gomailtest gomailtest-exchange gomailtest-gmail - Run e.g.:
./gomailtest --help
macOS (Apple Silicon/arm64):
- Download
gomailtesttool-macos-arm64-v4.1.4.zip - Extract:
unzip gomailtesttool-macos-arm64-v4.1.4.zip - Make executables:
chmod +x gomailtest gomailtest-exchange gomailtest-gmail - Run e.g.:
./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 gomailtest-exchange gomailtest-gmail
Quick Start Examples
SMTP Testing:
./gomailtest smtp testconnect --host smtp.example.com --port 25
./gomailtest smtp teststarttls --host smtp.example.com --port 587IMAP Testing:
./gomailtest imap testconnect --host imap.example.com --imaps
./gomailtest imap listfolders --host imap.example.com --imaps \
--username user@example.com --accesstoken "ya29..."POP3 Testing:
./gomailtest pop3 testconnect --host pop.example.com --pop3s
./gomailtest pop3 listmail --host pop.example.com --pop3s \
--username user@example.com --password "app-password"JMAP Testing:
./gomailtest jmap testconnect --host jmap.fastmail.com
./gomailtest jmap getmailboxes --host jmap.fastmail.com \
--username user@fastmail.com --accesstoken "token"EWS / Microsoft Graph:
./gomailtest-exchange ews testconnect --host mail.example.com
./gomailtest-exchange msgraph getinbox --tenantid "..." --clientid "..." --secret "..." \
--mailbox "user@example.com"Gmail / Google Workspace:
./gomailtest-gmail gmail listmessages --credentials credentials.json \
--mailbox user@gmail.comDocumentation
- Online: GitHub Repository