FilesDesk Watch Inbox: AI File Organizer for Email Attachments

FilesDesk is an AI file renamer and organizer for Mac and Windows. It reads what's inside your files and renames them by content. Watch Inbox pulls PDF and photo attachments from Gmail, Outlook, iCloud, Yahoo, Fastmail, Proton or any IMAP mailbox, renames them, and files them into the right folders.

I build FilesDesk, so read this as the builder's account, not an independent review. I'll cover how Watch Inbox works, how to set it up, how it compares to scripting it yourself, and where it falls short.

Quick answer: how do I automatically save and rename email attachments?
Connect your mailbox to FilesDesk Watch Inbox with an app password. Choose which senders, subjects and attachment types to match, and how far back to look. FilesDesk saves each matching PDF or photo to a local folder, renames it with AI based on what the file contains (or with your own template), and moves it using your Organize Flow rules. It only reads mail. Nothing is marked as read, moved or deleted.

FilesDesk Watch Inbox at a glance

What it is	Email attachment watcher inside FilesDesk, an AI file renamer
Platforms	macOS (Apple Silicon and Intel) and Windows
Mailboxes	Gmail, iCloud, Outlook, Yahoo, Fastmail, Proton, any IMAP account
Sign-in	App password only, never your main password
Mailbox access	Read-only
File types saved	PDFs and photos, including HEIC and HEIF
Renaming	Smart Rename (AI reads the file) or a custom template
Filing	Organize Flow rules with date-based folder paths
AI options	FilesDesk credits, your own API key, or local models via Ollama, LM Studio or vLLM

The problem: email attachments arrive with useless names

Every quarter my accountant sends the same message. Can you send me all the invoices for July to September?

And every quarter I'd open Gmail, search has:attachment invoice, and start clicking. Forty minutes later I had a Downloads folder full of invoice.pdf, invoice (1).pdf, invoice (2).pdf, Receipt-2419-3381.pdf and one mystery file called document.pdf that turned out to be a domain renewal.

FilesDesk's watch folders already renamed files the moment they landed in a folder. But the files still had to get to that folder, and that step was me, dragging attachments out of email by hand.

Meet Karan. He runs a two-person SaaS out of Pune. Every month his inbox collects bills from AWS, Vercel, GitHub, Google Workspace, his domain registrar, a Stripe receipt, and a couple of contractor invoices sent as scanned PDFs.

Finding those emails isn't hard. The pain is what happens after:

1. The attachment names are useless. Half of them are some variation of invoice.pdf.
2. The same PDF shows up twice because a vendor sent a reminder.
3. Nothing ends up in the right folder unless Karan puts it there.
4. He only does this when someone asks, so it's always a backlog.

A Gmail filter can label those emails. It can't open a scanned PDF, read the vendor name and billing month off page one, and name the file after them. An AI file renamer can. Watch Inbox connects the two.

How FilesDesk Watch Inbox works

Think of it as a watch folder whose source is a mailbox instead of a directory.

You connect an account, set filters, and pick a local folder. From then on, FilesDesk checks the mailbox, pulls matching attachments, and runs each one through three steps:

1. Save. The attachment is downloaded to the folder you chose.
2. Rename. Smart Rename reads the file using OCR for scanned PDFs, text extraction for digital ones, and AI vision for photos, then writes a descriptive name. Or it applies one of your templates, like the built-in Billing Documents or Bank Statements templates.
3. File. Organize Flows, FilesDesk's Trigger/Rule/Actions rules, move the renamed file to where it belongs, such as Finance/Invoices/2026/08/.

Here's what that looks like for Karan:

Arrives in email as	Ends up on disk as
invoice.pdf from AWS	Finance/Invoices/2026/08/AWS Invoice August 2026.pdf
Receipt-2419-3381.pdf	Finance/Receipts/2026/08/Stripe Receipt Postmark August 2026.pdf
scan_0042.pdf from a contractor	Finance/Contractors/2026/08/Riya Shah Design Invoice 0042.pdf

Exact names depend on your template and naming style. Title Case with spaces is the default as of 1.0.29.

Every saved attachment appears in History marked Saved, with the sender and subject beside it. When your accountant asks where a file came from, you can answer without opening your email.

How to set up Watch Inbox (step by step)

Setup takes about five minutes, most of it spent generating an app password. If you'd rather watch than read:

Step 1: Create an app password

FilesDesk never asks for your main email password. It only accepts an app password, a separate credential you can revoke on its own.

• Gmail: turn on 2-Step Verification, then create an app password in your Google Account security settings.
• iCloud Mail: generate an app-specific password at account.apple.com. Two-factor authentication is required.
• Yahoo Mail and Fastmail: both have an app password section under account security.
• Other IMAP providers: check your provider's help pages for the IMAP server, port, and app password support.

Step 2: Add the inbox in FilesDesk

Open the Automatic tab and add a new inbox. Pick your provider, or enter IMAP details manually, then paste the app password.

Step 3: Set your filters

Filters decide which attachments get saved. You can match on:

• Senders, such as [e-mail] or a whole vendor domain
• Subjects, such as invoice or receipt
• Attachment types, such as PDFs only
• How far back to look, so the first run backfills last quarter instead of your whole mailbox

Start narrow. One inbox for vendor bills, another for contractor invoices. You can duplicate an inbox and adjust it, which beats rebuilding filters from scratch.

Step 4: Choose the folder, naming, and filing rules

Pick where attachments land, then choose Smart Rename or a template. If you've set up Organize Flows, they apply automatically.

Step 5: Turn on Run on Startup

It's in Settings. Without it, the watcher stops whenever FilesDesk isn't running. With it, inboxes and watch folders resume after a restart.

From the Automatic tab you can pause an inbox, edit it, or run a check on demand.

Design decisions: why it's safe to connect your inbox

If you've ever written an IMAP script, you know fetching mail is the easy part. Everything around it is where scripts break.

Read-only access

FilesDesk doesn't mark messages as read. It doesn't move, label or delete them. Your inbox looks exactly the same after it runs.

This was non-negotiable. A tool that quietly marks your bank's email as read is a tool that makes you miss your bank's email. If you want mail archived after processing, use your mail client's own rules.

App passwords, never your main password

An app password can be revoked on its own. Stop using FilesDesk, delete that one credential, and nothing else changes.

It resumes where it stopped

Each inbox tracks its position. If your laptop sleeps, Wi-Fi drops, or the app restarts, it won't re-download old mail and it won't skip mail that arrived while it was offline.

This is the bug that bites most homemade scripts. They either reprocess the whole folder every run, or they rely on the unread flag, which breaks the moment you open the email on your phone.

Duplicates are caught by content

Vendors resend invoices. Reminder emails attach the same PDF again. FilesDesk compares file content, not filenames. Two different PDFs both called invoice.pdf are kept as separate files, and the same PDF sent twice is caught. You choose what happens: keep both, replace, or skip.

FilesDesk vs a Gmail script vs Zapier

You can build this yourself. For some people that's the right call. Here's how the options compare.

	FilesDesk Watch Inbox	Gmail filter + Apps Script	Zapier or Make
Mail providers	Gmail, Outlook, iCloud, Yahoo, Fastmail, Proton, any IMAP	Gmail only	Depends on the connectors you use
Where files go	Local folder on your Mac or PC	Google Drive	Usually a cloud drive
Renames by reading the file	Yes, AI plus OCR	Only if you write that code	Only with an extra AI step you set up
Duplicate detection	By content, built in	You write it	You build it
Folder routing rules	Organize Flows, built in	You write it	Filters and paths per zap
Offline AI option	Yes, via local models	No	No
Needs your computer on	Yes	No, runs in Google's cloud	No, runs in the cloud

My take: if you get invoices from one vendor and they're already well named, a Gmail filter and Apps Script are enough, and free. If you've got a dozen senders with scanned, inconsistent PDFs, the renaming and filing are where the hours go, and that's the part FilesDesk does for you.

Limitations to know before you set it up

• PDFs and photos only. Word documents, spreadsheets and ZIP files attached to emails aren't what Watch Inbox saves right now.
• Your computer has to be on. FilesDesk is a desktop app, not a cloud service. If your laptop is closed all weekend, Monday's run catches up on the backlog.
• Proton needs Proton Mail Bridge. Proton Mail's IMAP access goes through Bridge, which Proton offers on paid plans.

Frequently asked questions

What is FilesDesk?

FilesDesk is an AI file renamer and organizer for Mac and Windows. It reads the content of PDFs, scanned documents, photos and screenshots, then renames them with descriptive names and can sort them into folders automatically. It works with FilesDesk's own AI credits, your own OpenAI, Anthropic Claude or Gemini API key, or fully offline with local models through Ollama, LM Studio or vLLM.

What is FilesDesk Watch Inbox?

Watch Inbox is a FilesDesk feature, added in version 1.0.30, that monitors an email account and automatically saves matching PDF and photo attachments to a folder. It then renames them by content and files them using your rules.

Can FilesDesk automatically save Gmail attachments to a folder?

Yes. Connect Gmail with an app password, set sender, subject and attachment-type filters, and pick a destination folder. Matching attachments are saved, renamed and filed automatically.

Does it work with Outlook, iCloud and other email providers?

Yes. Watch Inbox supports Gmail, Outlook, iCloud, Yahoo, Fastmail, Proton and any mailbox that offers IMAP access with an app password.

Will FilesDesk mark my emails as read or delete them?

No. Access is read-only. Messages are never marked as read, moved or deleted.

Does FilesDesk need my email password?

No. It only accepts app passwords, never your main account password.

What happens if my computer restarts or loses connection?

Each inbox remembers its position and resumes without re-downloading old mail or missing new mail. Turn on Run on Startup in Settings so it starts automatically.

Can I process old emails, not just new ones?

Yes. Each inbox has a setting for how far back to look, which is useful for backfilling a quarter or a tax year.

Can I use FilesDesk offline?

Renaming can run fully offline with local AI models through Ollama, LM Studio or vLLM, so file contents never leave your computer. Watch Inbox itself still connects to your email provider to fetch mail.

Is FilesDesk available on Windows?

Yes. FilesDesk runs on Windows and macOS, including Apple Silicon and Intel Macs.

Where this leaves Karan

His July to September invoices are already sitting in Finance/Invoices/2026/, named by vendor and month. When the accountant asks, he zips a folder and sends it. That's the whole job now.

Watch Inbox ships in FilesDesk 1.0.30 and later. You can try the FilesDesk AI file renamer with 15 free trial credits. The full changelog is in the 1.0.30 release notes on GitHub, and if you're redesigning your folders at the same time, the folder structure guide is a good companion.

How do you handle email attachments today? Apps Script, Zapier, or a folder you clean once a year? Tell me in the comments.

Written by builder of FilesDesk. Last updated September 2026.