Obsidian Stats logoObsidian Stats

PST Import

by wenjunzhu
5
4
3
2
1
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Import Outlook PST email archives as Markdown files with metadata, attachments, and Obsidian wikilinks. Supports PST files of any size (including >2GB Unicode PST) via pure JavaScript.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

PST Import

Import Outlook PST email archives into Obsidian as Markdown files with metadata, attachments, and wikilinks.

Features

  • 📧 Export all emails from PST files as Markdown
  • 📁 Preserve PST folder structure (Inbox, project folders, etc.)
  • 🖼️ Embedded images auto-convert to Obsidian ![[wikilink]] format
  • 📎 Save attachments to attachments/ subdirectory
  • 📋 YAML frontmatter with complete metadata (sender, recipients, date, etc.)
  • 🚀 Pure JavaScript single engine (pst-extractor), no Outlook or external executables required
  • 📂 Pre-import folder selection (support multi-select/select-all)

Installation

From Obsidian Community Plugins

  1. Open Obsidian → Settings → Community Plugins → Browse
  2. Search for "PST Import"
  3. Click Install
  4. Enable in installed plugins list

If not yet available in the store, you can use BRAT or manual installation.

Install with BRAT

  1. Install BRAT plugin
  2. Add repository: wenciara/obsidian-pst-importer
  3. Enable PST Import

Manual Installation

  1. Go to Releases
  2. Download the latest main.js and manifest.json (and styles.css if available)
  3. Place files in vault's .obsidian/plugins/pst-import/ directory
  4. Enable plugin in Obsidian settings

Usage

  1. Click the email icon 📧 in the left ribbon, or run "Import PST file..." command
  2. Select a .pst file
  3. Select which email folders to import (multi-select available)
  4. Enter folder name for import destination (defaults to PST filename)
  5. Wait for import to complete (large files may take a few minutes)
  6. Imported emails appear in your target directory

Settings

Setting Description Default
Output Base Directory Folder in vault to store imports PST Import
Preserve Folder Structure Create subdirectories for PST folders Enabled
Overwrite Existing Files Overwrite duplicate email filenames Disabled
Include YAML Frontmatter Generate metadata headers Enabled

Output Structure

vault/
└── PST Import/
    └── ArchiveName/
        ├── Inbox/
        │   ├── 2020-07-02_sender_subject.md
        │   └── attachments/
        │       ├── 2020-07-02_sender_document.pdf
        │       └── 2020-07-02_sender_image.jpg
        ├── Any Topic/
        │   └── ...
        └── ...

System Requirements

  • Obsidian Desktop (isDesktopOnly)
  • Obsidian v1.5.0+

Development

# Clone
git clone https://github.com/wenciara/obsidian-pst-importer
cd obsidian-pst-importer

# Install dependencies
npm install

# Development build (watch mode)
npm run dev

# Production build
npm run build

Release Build

GitHub Actions automatically builds releases on tag push:

# Create and push tag
git tag 1.0.1
git push origin 1.0.1

The workflow builds and publishes plugin files (main.js, manifest.json, styles.css).

License

MIT

Sponsors