How to open an mbox file
A mailbox download as a spreadsheet of every email and one folder of its attachments.
A real run on 14 November 2026, on a Linux computer, using Claude Code with Opus, on a Claude plan. The waiting is sped up; it took 1 min 45 s in real time.
The short answer.
An mbox is one big text file holding a whole mailbox, as Google Takeout gives you Gmail. To read it, import it into a mail program: the free Thunderbird with the ImportExportTools NG add-on on Windows, Mac or Linux, or Apple Mail's Import Mailboxes on a Mac. Stella (stella.sh) opens it without any mail program: a spreadsheet with a row for every email and a folder of all the attachments, with readable subjects and no file overwritten by another of the same name.
Stella does this on Windows, Mac and Linux.
What happened.
About a minute. Checked afterwards against an answer key written before the run: a row for each of the 45 emails with sender address, readable subject and date, all 12 attachments saved as files including both different invoice.pdf files, and the accented attachment name readable.
The mailbox is made up, written in the format of a Gmail Takeout mbox, including encoded subjects and two attachments with the same name. The work is sped up 5×.
How Stella does it.
- Opens the Google Takeout zip in Downloads and finds the mbox of 45 emails inside it
- Decodes the subjects and file names that are stored in encoded form, so “Café de Flore – réservation confirmée” and “Reçu Novembre.pdf” read right
- Writes
Email list.xlsxwith the date, sender name and address, recipient, subject, Gmail labels and attachments of every email - Saves all 12 attachments into one Attachments folder, keeping two different files both called invoice.pdf as
invoice.pdfandinvoice (2).pdf - Notes that one attachment was already damaged in the original email, puts it all in a new Old Gmail export folder and leaves the zip unchanged
The prompt.
I downloaded my old email from Google and got a zip in my Downloads with an mbox file I can't open. Make me a spreadsheet listing every email with the date, who it's from and the subject, and save all the attachments into one folder.
This is the exact prompt from the recording. If your files are somewhere else, say where.
Do it yourself.
Get the mbox out of the zip
Google Takeout puts Gmail in
Takeout/Mail/as a file such asAll mail Including Spam and Trash.mbox. Unzip the download first; the mbox can be several gigabytes for a big mailbox.Mac: import into Apple Mail
In Mail, File, Import Mailboxes, choose Files in mbox format and pick the folder holding the .mbox. The emails appear under On My Mac. Select messages and use File, Save Attachments to save their files.
Windows, Mac or Linux: Thunderbird
Install the free Thunderbird and its ImportExportTools NG add-on (Tools, Add-ons). Right-click Local Folders, ImportExportTools NG, Import mbox file, and pick the .mbox. No email account is needed for this.
List the emails and save attachments
Right-click the imported folder, ImportExportTools NG, Export all messages in the folder, Spreadsheet (CSV) for a list. To save attachments, select all messages and use the add-on's save attachments option. Check for files with the same name, which some tools overwrite or skip.
Where it stops.
- A mailbox of many gigabytes takes a while; Stella works through it on your computer, so allow time and disk space.
- Stella reads the mailbox to build the list, and the headers and email text it reads go to the AI model you use in Stella.
- It can't repair an attachment that was already broken in the email; in the run it said which one and who to ask for it.
- Recorded on Linux. On a Mac or Windows PC Stella may first install Python or a small spreadsheet library, which wasn't recorded.
Questions.
What is an mbox file?
A plain text file with a whole mail folder in it, one email after another. Google Takeout, Thunderbird and Apple Mail all use it for exports.
Can I open an mbox file without installing an email program?
Not usefully on its own: a text editor shows raw headers and encoded attachments. Stella reads it directly and gives you a spreadsheet and the files.
Can I turn some of the emails into a PDF?
Yes: see convert EML to PDF, which puts one person's emails in one PDF by date.
Can it do the same with chat downloads?
Is Stella free for this?
Yes. Free with the ChatGPT or Claude plan you already have. Sign in with your ChatGPT plan, or use your Claude plan through Claude Code, and this task costs nothing extra. New accounts also get a small free trial of Stella’s own models.
Can I control what Stella changes on my computer?
Yes. Stella works on Windows, Mac and Linux with your own files and shows each step in the chat, so you can watch it and stop it at any point. Tell it what it may not do, as the prompts on these pages do (“don't delete anything without asking”). In the Downloads recording it deleted nothing until it was told to go ahead. It also refuses commands that would wipe a whole disk, your home folder or system folders.
Checked against these sources on 14 November 2026.