# How to open an mbox file

> Markdown version of https://stella.sh/how/contacts-calendar-email/open-mbox-file for agents and LLMs.
> Open the mbox from Google Takeout or Thunderbird: list every email with date, sender and subject and save all the attachments, with Thunderbird or Stella (stella.sh).

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.

- Checked: 14 November 2026
- Stella does it on: Windows, Mac, Linux

## Stella doing it

Recorded 14 November 2026 on Linux (Omarchy) with Claude Code with Opus, on a Claude plan.
Result: 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×.

Video (42 s): https://stella.sh/media/proofs/contacts-calendar-email/open-mbox-file/proof.mp4

Transcript:

- 0:00 Stella on a Linux computer. A Google Takeout zip with an mbox of old email is in Downloads.
- 0:02 The prompt: a spreadsheet of every email and all the attachments in one folder.
- 0:10 Stella replies: one row per email, every attachment kept even when two share a name.
- 0:16 Reading the mailbox, sped up 5×.
- 0:28 Done: 45 emails listed and 12 attachments saved, with one file that was damaged in the original email.

What Stella does:

1. Opens the Google Takeout zip in Downloads and finds the mbox of 45 emails inside it
2. 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
3. Writes `Email list.xlsx` with the date, sender name and address, recipient, subject, Gmail labels and attachments of every email
4. Saves all 12 attachments into one Attachments folder, keeping two different files both called invoice.pdf as `invoice.pdf` and `invoice (2).pdf`
5. 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 to paste

```text
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.
```

## Open it yourself

1. **Get the mbox out of the zip.** Google Takeout puts Gmail in `Takeout/Mail/` as a file such as `All mail Including Spam and Trash.mbox`. Unzip the download first; the mbox can be several gigabytes for a big mailbox.
2. **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.
3. **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.
4. **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 Stella 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](https://stella.sh/how/contacts-calendar-email/convert-eml-to-pdf), which puts one person's emails in one PDF by date.

**Can it do the same with chat downloads?**
Yes: see [read Facebook messages from your data download](https://stella.sh/how/chats-data-exports/read-facebook-messages-from-data-download) and [export a WhatsApp chat to PDF](https://stella.sh/how/chats-data-exports/export-whatsapp-chat-to-pdf).

**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.

Sources: [Google Account Help: Download your data](https://support.google.com/accounts/answer/3024190), [ImportExportTools NG add-on for Thunderbird](https://addons.thunderbird.net/en-US/thunderbird/addon/importexporttools-ng/).

## Related problems

- [Convert EML files to one PDF, oldest first](https://stella.sh/how/contacts-calendar-email/convert-eml-to-pdf.md)
- [Read your Facebook messages from the data download](https://stella.sh/how/chats-data-exports/read-facebook-messages-from-data-download.md)
- [Find files containing text, whatever type of file they are](https://stella.sh/how/files-folders/find-files-containing-text.md)
- [Convert a contacts CSV to a VCF file for your phone](https://stella.sh/how/contacts-calendar-email/convert-csv-to-vcf.md)
- [Convert a VCF contacts file to Excel](https://stella.sh/how/contacts-calendar-email/convert-vcf-to-excel.md)
- [Merge duplicate contacts from two lists](https://stella.sh/how/contacts-calendar-email/merge-duplicate-contacts.md)

Get Stella: https://stella.sh/download. Free with the ChatGPT or Claude plan you already have.
