DocsGetting StartedAccount Setup & Providers
Master Docs Hub Index
Getting Started • Step 2

Account Setup & Provider Configuration

Nuncio connects to unlimited email and calendar accounts across any standard IMAP/SMTP host, JMAP provider, or Google Workspace.

1. Standard IMAP & SMTP Provider Setup

Add standard email accounts (ProtonMail Bridge, Fastmail, Posteo, custom domain servers) via CLI or GUI:

# Add IMAP/SMTP account via CLI
nuncio account add \
  --label "Work Mail" \
  --email "james.maes@kof22.com" \
  --imap "mail.kof22.com:993" \
  --smtp "mail.kof22.com:465"

2. Google Workspace & Gmail OAuth 2.0 PKCE (`RFC 7636`)

Nuncio supports native OAuth 2.0 Proof Key for Code Exchange (`RFC 7636`). You never enter or store raw Google account passwords.

# Add Google account via CLI
nuncio account add --provider google --email "user@company.com"

# Nuncio opens http://127.0.0.1:9422/oauth/callback in your system browser.
# Refresh tokens are encrypted and stored inside OS Keyring (DPAPI / Keychain Access).
Zero Raw Passwords in SQLite Storage

All account passwords, OAuth 2.0 refresh tokens, and private SASL credentials are isolated directly inside your operating system's hardware-backed credential vault (macOS Keychain Access, Windows DPAPI, or Linux Secret Service via `keyring-rs`). SQLite databases store zero credential strings.