Configuring SagaMail Settings
Customize SagaMail to fit your workflow by adjusting preferences, privacy options, and advanced configurations.
curl -X POST http://localhost:8080/api/v1/emails/archive \
-H "Content-Type: application/json" \
-d '{"ids": ["msg-123"]}'
const response = await fetch('http://localhost:8080/api/v1/emails/archive', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ ids: ['msg-123'] })
});
{
"success": true,
"archived": 1
}
{
"error": "Invalid message ID"
}
Overview
SagaMail offers extensive configuration options to tailor the app to your needs. Access settings via SagaMail > Preferences in the menu bar or Cmd + ,. Categories include accounts, privacy, appearance, rules, and the local REST API.
Save changes immediately after adjustments. Restart SagaMail for some advanced options to take effect.
Managing Account Settings
Add and configure email accounts like Gmail, Outlook, or custom IMAP servers. SagaMail supports unified inbox with color coding per account.
Use OAuth for secure access.
Enable IMAP
In Gmail settings, go to Forwarding and POP/IMAP and enable IMAP.
Add Account
In SagaMail, select Add Account > Gmail and sign in.
Connect any IMAP server.
IMAP server address, e.g., imap.gmail.com.
Port number: 993 for SSL.
Your email address.
App-specific password for 2FA accounts.
Privacy and Data Storage
SagaMail prioritizes privacy with local storage only. No data leaves your Mac.
Disable telemetry and set cache limits in Preferences > Privacy.
- Local Storage Path: Defaults to
~/Library/Application Support/SagaMail. - Auto-Clean: Delete emails older than 30 days.
- Encryption: Enable disk encryption for stored emails.
All processing, including AI triage, happens on-device using Apple Silicon Neural Engine.
Keyboard Shortcuts and Themes
Customize j/k navigation, e archive, # trash, and more. Choose from light, dark, or solarized themes.
Open Shortcuts
Go to Preferences > Keyboard.
Remap Keys
# Example: Bind 'd' to delete
# Edit ~/.sagamil-shortcuts.json
{
"delete": "d"
}
Select Solarized Dark for high contrast.
Smart Rules
Automate labeling, archiving, and forwarding.
Create Rule
Preferences > Rules > Add Rule.
Define Conditions
Match sender newsletter@company.com or subject invoice.
Set Actions
Label Invoices, archive after 7 days.
Example rule JSON:
{
"conditions": [
{"field": "from", "operator": "contains", "value": "newsletter"}
],
"actions": [
{"type": "label", "value": "News"},
{"type": "archive", "delay": 7}
]
}
-- Export rules via Shortcuts
tell application "SagaMail"
export rules to "~/rules.json"
end tell
Local REST API
Automate SagaMail with the built-in API at http://localhost:8080/api/v1.
Array of message IDs to archive.
Last updated today
Built with Documentation.AI