How to convert MBOX to CSV
An mbox file is one long text file that holds many email messages. Each message starts with a line that begins with From and a date. To convert mbox to csv, the tool finds each message, reads its headers and body, and writes one row per message, with the columns you chose.
"Date (ISO, UTC)",From name,From address,Subject,Gmail labels,Body text
2026-01-05T09:30:00Z,José Silva,jose@example.com,Invoice 2026-001,"Inbox,Important","Hello Ana,
the invoice is attached."
2026-01-06T14:05:00Z,Ana,ana@example.com,Re: Invoice 2026-001,Sent,"Thanks, received."Your mail never leaves your device. The file is read with your browser's file API, as the Privacy Policy describes, and nothing is sent to a server.
Gmail Takeout and Thunderbird files
To get your Gmail as mbox, use Google Takeout and select Mail. Takeout gives one .mbox file for All mail, or one file per label if you choose labels. Every message in it carries an X-Gmail-Labels header, which this tool can write into a Gmail labels column, so you can filter or sort by label in a spreadsheet.
Thunderbird keeps each folder as an mbox file without an extension, in the profile folder. Copy the file to your desktop and open it here. Apple Mail can export a mailbox as .mbox as well. A single .eml message pasted or opened as a file is read as one message.
Large mailboxes
A mailbox export can be several gigabytes. The tool does not load it all at once. It reads a slice at a time, splits out the messages in that slice, writes their rows and moves on, so memory use follows the largest single message and not the file size. The page stays responsive and a Cancel button stops the job.
- The CSV is built in pieces that the browser can keep outside memory, so very large results are possible, within the limits of your browser and free disk space.
- Only the first 200 rows are kept for the preview, and the summary keeps counts, not the messages.
- Message boundaries are found by the From line with a date, so a body line that merely begins with the word From does not split a message. Lines such as >From in a message body are turned back into From, as the mboxrd format requires.
Columns you can export
- Date in ISO form (UTC) and in your browser's time zone.
- From name and From address, and To, Cc and Bcc with names and addresses.
- Subject, Message-ID and In-Reply-To, which lets you rebuild conversation threads in a spreadsheet.
- Gmail labels from the X-Gmail-Labels header.
- Attachment count and attachment names. The files themselves are not extracted.
- Message size in bytes and the body text, cut to a length you choose.
Subjects and names with accents or other scripts, such as =?UTF-8?Q?Caf=C3=A9?=, are decoded. Bodies in quoted-printable or base64 are decoded using the charset the message declares. When a message has only an HTML part, tags are removed to give the text.
Filters and one row per recipient
Filters apply while the file is read, so rows you do not need are never written. Combine them freely: for example label Inbox, from a domain and the dates of one quarter. Text filters ignore upper and lower case. A date filter leaves out messages that have no readable date, and the summary says how many.
By default there is one row per message, and recipients are joined in one cell. Switch on One row per recipient to get a row for each To, Cc and Bcc address, with columns for the recipient name, address and type. Use it to count how many messages each person received.
CSV details and safety
Cells that contain the delimiter, quotes or line breaks are quoted, and quotes are doubled, so the file opens correctly in Excel, Google Sheets and LibreOffice. The UTF-8 BOM option helps Excel on Windows show accents and non-Latin letters.
A cell that starts with =, +, - or @ can be run as a formula by a spreadsheet. Because emails can contain text like that, such cells are given a leading apostrophe. This protects you when you open a mailbox that contains untrusted messages.
Limits
- The tool reads headers and text. It does not extract attachment files or show message images. For a single message, use the EML Viewer.
- Changing the columns or filters means reading the file again, because the messages are not kept in memory. Press Convert again.
- Very unusual files, such as an mbox with broken message boundaries, can merge or split messages. The summary shows the count so you can compare it with your mail program.
- A Date header without a time zone is read as UTC, so the result does not depend on your computer's settings.
- A file that does not look like an mbox or an email gives no messages, and the tool says so.
- It converts your own export. It does not connect to an email account.
Once you have the CSV, Merge CSV Files joins several exports, and CSV to Markdown turns rows into a table for a document. VCF to CSV does the same job for a contacts file.