outlook-to-mdlisted
Install: claude install-skill dbhq-uk/outlook-graph-skill
# Outlook Email to Markdown
Turn Outlook mail into an organised, integrity-verified archive of markdown files, raw email backups, and attachments. Reads a PST export, or a directory of `.eml` files - which is how live mail arrives, via the sibling `outlook-graph` skill's `export` verb. Supports full extraction and incremental append mode, so one archive can span both.
## Prerequisites
- Python virtual environment set up (run setup.sh if not done)
- At least one of: `libratom` (Python) or `readpst` (system tool from pst-utils)
### First-Time Setup
```bash
# Set up Python environment (one-time)
${CLAUDE_SKILL_DIR}/setup.sh
```
### System Dependencies (optional fallback)
If libratom installation fails, install readpst as a fallback:
```bash
# Ubuntu/Debian
sudo apt install pst-utils
# macOS
brew install libpst
```
## Extraction Operations
### Full Extraction
Extract all emails from a PST file into markdown:
```bash
# Basic extraction
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/outlook_to_md.py /path/to/file.pst /path/to/output/
# Verbose output with progress
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/outlook_to_md.py /path/to/file.pst /path/to/output/ --verbose
# Include deleted items
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/scripts/outlook_to_md.py /path/to/file.pst /path/to/output/ --include-deleted --verbose
# Set timezone for date display
${CLAUDE_SKILL_DIR}/.venv/bin/python ${CLAUDE_SKILL_DIR}/script