thunderbird-reader

Extract headers and plain-text bodies from Thunderbird Mbox files via Python.

15|2|Updated May 26, 2025
One-click install
npx skills add https://github.com/Manamama/Puzzles_for_AIs --skill thunderbird-reader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thunderbird-reader
Source: https://github.com/Manamama/Puzzles_for_AIs/tree/main/skills/thunderbird-reader
Command: npx skills add https://github.com/Manamama/Puzzles_for_AIs --skill thunderbird-reader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Thunderbird Mbox emails from the command line can be hard to access and inspect; this Skill provides a Python-based workflow to read and decode headers and bodies from Mbox files.

Core Features & Use Cases

  • Read and decode Thunderbird mbox messages from the CLI
  • Extract headers (From, Date, Subject) and the plaintext body
  • Use with local Thunderbird profiles to automate read-only email inspection in scripts

Quick Start

Update MBOX_PATH to your Thunderbird profile and run python3 read_email.py

Frequently Asked Questions about thunderbird-reader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read Thunderbird mbox files from the command line?

You can read Thunderbird mbox files from the command line using a Python script that leverages the standard library's mailbox module to parse and decode email headers and plaintext bodies.

How do I extract email headers like From and Date from a local Thunderbird profile?

To extract email headers from a local Thunderbird profile, point a Python parsing script to your mbox file path to decode and read specific headers such as From, Date, and Subject.

Can I parse multiple mbox messages at once with Python?

Yes, you can parse multiple mbox messages at once by iterating through the mbox file with Python's standard mailbox module to extract headers and plain-text bodies from single or multiple messages.

Do I need any external Python packages to parse Thunderbird emails?

No external Python packages are needed to parse Thunderbird emails; the script requires only Python 3 and uses the standard library's mailbox module to handle mbox file parsing and header decoding.

Does this Python mbox parsing approach work on Windows?

This Python mbox parsing approach is designed for local Thunderbird profiles on Unix-like systems, so it is not explicitly tested or supported for extracting emails on Windows environments.