Turn local mailbox exports into simple application reports for students and early-career applicants.
Inbox Report reads .mbox and .eml exports, detects likely job, COOP, internship, Tamheer, and training application emails, then writes CSV, HTML, and optional PDF reports.
No inbox login. No email password. No cloud upload. No external API. No LLM.
git clone https://github.com/mara-org/inbox-report.git
cd inbox-report
python3 inbox_application_reporter.py demoThat creates a fake mailbox and demo reports under .demo/.
For a real Gmail export:
python3 inbox_application_reporter.py report /path/to/Takeout/Mail --openFor a single MBOX file:
python3 inbox_application_reporter.py report /path/to/Mail.mbox --openFor a folder of EML files:
python3 inbox_application_reporter.py report /path/to/eml-folder --openIf the report is empty but you expected applications, run audit mode:
python3 inbox_application_reporter.py audit /path/to/Mail.mbox --openPrefer questions instead of flags:
python3 inbox_application_reporter.py wizardWant Codex, Claude Code, Cursor, or another local agent to run it for you? Give it AGENT_HANDOFF.md. The handoff prompt tells the agent to run the demo, ask for your local export path, generate the report, and avoid passwords or uploads.
student_summary.csv: next-step list sorted by action priority.applications.csv: detailed matched emails.applications_summary.csv: organization-level counts.applications_report.html: browser report.applications_report.pdf: PDF report when optional PDF dependencies are installed.
Use redacted mode before sharing reports:
python3 inbox_application_reporter.py redact /path/to/Mail.mbox --openPython 3.9+ is supported. The CSV and HTML flow uses the Python standard library, so direct script usage works without installing runtime packages.
Optional package install:
python3 -m pip install "inbox-report[pdf]"
inbox-report --versionLocal development:
python3 -m pip install -e ".[pdf]"
python3 -m pip install -r requirements-dev.txt
make checkMailbox exports and generated reports can contain sensitive personal data. Keep real .mbox, CSV, HTML, and PDF files private unless you intentionally redact and share them.
This project is maintained under the mara on GitHub.
Created by @gqnxx · Improved by @justAbdulaziz10