| name | pst-converter |
| description | Convert Microsoft Outlook Personal Storage Table (.pst) files into AI-friendly formats (Markdown, JSON, CSV). Use this skill to extract emails, metadata, and attachments from legacy email archives for analysis, context, or migration. |
| allowed-tools | ["run_terminal_cmd","read_file"] |
PST Converter Skill
Description
This skill provides a tool to extract and format data from Outlook PST files. It is useful for:
- Reading legacy email archives.
- Converting PST content to Markdown for LLM context.
- Extracting metadata for analysis (CSV/JSON).
Requirements
- System:
libpst must be installed.
- macOS:
brew install libpst
- Linux:
sudo apt-get install pst-utils
- Python: Python 3.8+ (Standard library only).
Instructions
Run the cli.py script found in this directory.
Basic Syntax
python3 cli.py <path_to_pst_file> [options]
Options
-f, --format: Output format. Choices: markdown (default), json, csv, both (md+json), all.--full: Include full email bodies (default is metadata-only).--folders: Preserve original folder structure.--include-threading: Include thread ID metadata.-o, --output <dir>: Specify output directory (default: ./output).
Examples
1. Quick Summary (Metadata only)
Good for scanning an archive's contents.
python3 cli.py archive.pst
2. Prepare for LLM Context (Markdown)
Extracts full content into a readable Markdown format.
python3 cli.py archive.pst --full -f markdown
3. Data Analysis (JSON/CSV)
Extract structured data.
python3 cli.py archive.pst --full -f json
Troubleshooting
readpst not found: Install libpst via your system package manager.
