MSF File Documentation

Summary

An .msf file is a Mail Summary File created by Mozilla Thunderbird (or SeaMonkey). It is an index for a mail folder — message headers, subjects, read/unread status and threading — and holds no actual email content. The real messages sit in the matching file next to it that has the same name but no extension (so INBOX.msf indexes the INBOX mailbox). You rarely open a .msf yourself: if a folder misbehaves, close Thunderbird and delete just the .msf, or use Repair Folder, and Thunderbird rebuilds it.

Technical details

Feature	Value
Full name	Mail Summary File (Mozilla Thunderbird / Mork index)
File extension	`.msf`
MIME type	`application/octet-stream`
Format type	Plain-text index/database in Mork format
Role	Folder summary/cache — NOT the messages themselves
Developer	Mozilla (Thunderbird, SeaMonkey); Mork originated at Netscape
Introduced	Used by Thunderbird since 2003
Open standard	No
Header line	`// <!-- <mdb:mork:z v="1.4"/> -->`
Holds	Headers, subjects, dates, message-IDs, flags, thread info
Does not hold	Email bodies or attachments
Message store	The matching extension-less file (mbox), e.g. `INBOX`
Location	Thunderbird profile under `Mail/` or `ImapMail/`
Safe to delete	Yes — rebuilt automatically (delete only the `.msf`)
Rebuild via	Folder › Properties › Repair Folder
Related extensions	`.mbox`, `.eml`, `.sbd`, `.dat`
Specification	`wiki.mozilla.org/Mork`

Structure at a glance

An .msf is a Mork-format text database and begins with the Mork header comment // . The body is roughly readable text but written as a compact dictionary-and-row syntax: interned column names and value atoms, then rows — one per message — recording subject, sender, date, message-ID, flags and thread relationships. It is not meant for manual reading and holds no email text. The actual messages live in the matching same-named file with no extension (mbox format) sitting beside it.

What is an MSF file?

MSF stands for Mail Summary File. Mozilla Thunderbird, its sibling SeaMonkey, and historically Netscape Mail store each mail folder as a pair of files: a mailbox file with no extension that holds the actual messages, and a same-named .msf file that is its summary index. So the folder INBOX is stored as a file called INBOX containing the mail, plus INBOX.msf that indexes it. The .msf caches per-message metadata — sender, subject, date, message-ID, read/unread and flag status, thread relationships — so Thunderbird can display and sort a folder instantly without re-parsing the whole mailbox each time.

The critical fact is that a .msf contains no email bodies and no attachments. It is purely an index. Because it is only a cache, it is disposable: if a folder shows wrong counts or missing messages, the fix is to let Thunderbird regenerate the index, not to repair the .msf by hand.

The Mork format: why it looks like gibberish

An .msf is written in Mork, an old Mozilla text-database format inherited from Netscape. It opens in a text editor as cryptic dictionary-and-row syntax rather than readable mail, which is exactly why people who open one expecting to find their emails see nonsense. Every Mork file starts with the same header comment identifying the format and version:

// <!-- <mdb:mork:z v="1.4"/> -->

Below the header, Mork interns repeated strings into dictionaries: column names and common values are each assigned a short hexadecimal id, and the rows then reference those ids instead of repeating the text. A row is one message's metadata — its subject, sender, date, message-ID, flags and thread links — encoded as a set of id-to-value pairs. This compaction is what makes Mork fast and small, and also what makes it unreadable to a human. It was never meant to be read directly; it is a machine index.

The mailbox pairing: where the mail actually is

The most useful thing to understand about a .msf is what it is not. Your emails are in the matching file with the same name and no extension, stored in mbox format. The .msf merely points into and summarises that mailbox.

Mail/Local Folders/
  INBOX        <- the mailbox: actual messages (mbox format)
  INBOX.msf    <- the summary index for INBOX (metadata only)
  Sent         <- mailbox
  Sent.msf     <- its index

This pairing is why deleting the wrong file is the one real hazard. Deleting INBOX.msf is harmless — Thunderbird rebuilds it. Deleting INBOX destroys the actual messages. When troubleshooting, always delete only the file whose name ends in .msf, never the matching extension-less mailbox. Thunderbird profiles keep these pairs under Mail/ (local and POP folders) and ImapMail/ (IMAP folders).

Rebuilding a broken index

Because the .msf is only a cache, the standard fix for a folder that shows wrong message counts, missing or reappearing messages, or that will not update, is to regenerate its index. There are two ways. From inside Thunderbird, right-click the folder, choose Properties, and click Repair Folder, which rebuilds the .msf in place. Alternatively, close Thunderbird completely and delete just the folder's .msf file; it regenerates on the next start. Close Thunderbird first so it is not holding the file open, and back up the profile before mass-deleting indexes.

Conversions do not apply to a .msf in any normal sense. To export messages as mbox or .eml, or to migrate mail into Outlook as PST, you operate on the mailbox (drag messages out of Thunderbird, or use the ImportExportTools NG add-on), never on the .msf — it holds no message bodies to convert, and it is rebuilt rather than migrated. Likewise, backups should capture the extension-less mailbox files and the rest of the profile; the .msf indexes are regenerated automatically and do not need backing up. Note that .msf is also used by unrelated tools, such as Metasploit resource scripts, but the Thunderbird Mail Summary File is the dominant meaning.

Frequently asked questions

Is it safe to delete .msf files?

Yes, if Thunderbird is closed and you delete only the .msf. Thunderbird rebuilds it on the next start. Never delete the matching extension-less file (for example INBOX); that one holds your real emails.

How do I read the emails in an .msf file?

You cannot — an .msf is only an index. The actual messages are in the same-named file with no extension, in mbox format. Open that mailbox in Thunderbird, or import it into another mail client.

My folder shows wrong or missing messages — how do I rebuild the index?

Right-click the folder, choose Properties, and click Repair Folder, which rebuilds the .msf. Alternatively, close Thunderbird and delete just that folder's .msf file; it regenerates on restart.

References

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.

Table of contents