README file from
GithubEmail to Vault
This is a plugin for Obsidian that syncs emails into your vault as notes. Create a free disposable mailbox with one click, or connect your own IMAP server (Gmail, Outlook, etc.). No backend or paid service required. Inspired by Save emails into Evernote feature.


Features
- Two email modes — use the built-in disposable mailbox (Mail.tm) or connect your own IMAP server
- One-click mailbox creation — get a dedicated email address instantly from the plugin settings (Mail.tm mode)
- IMAP support — connect to any IMAP-compatible email server such as Gmail, Outlook, or a self-hosted server (desktop only)
- Completely free — no paid service, no self-hosted server, no external account needed
- Automatic sync — the plugin periodically checks for new emails and saves them as notes
- Full metadata preservation — From, To, CC, Subject, Body, and Attachments are all captured
- Works on desktop and mobile (IMAP mode is desktop only)
How it works
Mail.tm mode (default)
- Open the plugin settings and click Create Mailbox to generate your unique email address
- Forward or send emails to that address
- The plugin automatically fetches new emails and creates notes in your vault
IMAP mode
- Open the plugin settings and select IMAP as the email provider
- Enter your IMAP server details (host, port, TLS) and credentials
- For Gmail with 2FA, use an App Password
- The plugin connects to your mailbox, fetches new emails, and creates notes in your vault
[!NOTE]
IMAP mode is only available on desktop. On mobile devices, use Mail.tm instead.
Privacy & data handling
Mail.tm mode
[!WARNING]
Emails are routed through a third-party server mail.tm.
Do not send sensitive information — use at your own risk.
This plugin uses mail.tm as the email provider. Message contents, sender addresses, and attachments are processed on third-party infrastructure before reaching your vault. Known properties of the provider (according to their FAQ):
- Messages are retained for up to 7 days on mail.tm servers.
- mail.tm claims it does not store IP addresses, but does not publish its jurisdiction, governing law, or corporate location.
- No GDPR/CCPA compliance claim is made by the provider.
By using this plugin, you acknowledge that any information you send — including sensitive or private data — is transmitted at your own risk. The plugin author makes no warranties regarding the confidentiality, integrity, or availability of data handled by mail.tm.
IMAP mode
In IMAP mode, the plugin connects directly to your email server. No data is routed through third-party services beyond your own email provider. Your IMAP password is stored in Obsidian's built-in secret storage.
Installation
The plugin is available in the official Community Plugins repository.
Beta versions
To install the latest beta release of this plugin (regardless if it is available in the official Community Plugins repository or not), follow these steps:
- Ensure you have the BRAT plugin installed and enabled.
- Click Install via BRAT.
- An Obsidian pop-up window should appear. In the window, click the
Add pluginbutton once and wait a few seconds for the plugin to install.
Debugging
By default, debug messages for this plugin are hidden.
To show them, run the following command in the DevTools Console:
window.DEBUG.enable('email-to-vault');
For more details, refer to the documentation.
Support
My other Obsidian resources
See my other Obsidian resources.