Mailslide

A Windows + Outlook Classic automation tool for turning repetitive email work into reliable workflows. Use configurable jobs and optional LLM plugins to classify, route, summarize, and structure email processing.

Language: English | Traditional Chinese

Warning: AI reads your emails. Make sure emails processed by AI do not contain personal privacy data or business confidential information, or use a local model for processing.

Disclaimer: This project is provided as-is and does not guarantee the security of data processed by third-party or local AI models. The project authors are not liable for any data breach, confidential information leakage, or related damages resulting from user inputs or model services. Users are responsible for risk assessment and compliance with organizational policies and applicable laws.

Why Mailslide

• Standardize Outlook processing with repeatable job-based workflows.
• Go beyond classification: move folders, create appointments, export JSON/CSV/Excel.
• Keep deployment flexible: OpenAI-compatible APIs or local models (Ollama, llama.cpp).
• Friendly for non-developers: initialize and edit configs directly in the TUI.

Typical use cases

• Operations and assistants: triage meeting requests, alerts, and routine inbox traffic.
• PMs and sales: convert email streams into trackable events and summaries.
• Engineering and support: auto-tag and prioritize incoming threads.

Recent workflow updates

• Home -> Stop now halts a running job from the Home tab.
• Configuration -> General -> Reload rereads config/config.yaml from disk.
• Plugin settings now support prompt profiles, and renaming a profile key tries to keep related job references in sync.

30-second start (End users)

uv tool install mailslide
mailslide-tui

After first launch, open About and click Initialize Config.

Upgrade:

uv tool upgrade mailslide

Pre-release compatibility (LLM path):

• Canonical LLM dependency policy is defined in pyproject.toml under project.optional-dependencies.llm.
• Current incident-closure policy for LLM execution path is httpx<1.
• Release-candidate validation evidence lives in docs/releases/evidence/ (see the file matching the target RC tag, e.g. X.Y.Z-rcN.md).

When a release changes config schema, the app auto-migrates config/config.yaml on load and writes a timestamped backup (for example: config.yaml.bak.20260327_153000).

30-second start (Developers / source mode)

uv sync
uv run app.py

Then in TUI:

1. Open About and click Initialize Config.
2. Open Configuration and set Jobs / LLM / Plugins.
3. Return to Home and run a job (Preserve RE/FW is ON by default and can be toggled on Home).

Import Path Migration

• Canonical path: mailslide
• Legacy path: outlook_mail_extractor (deprecated, planned removal in the next major release)

Screenshots

Plugin Capability Matrix

Full Guide

• English: GUIDE.en.md
• Traditional Chinese: GUIDE.md

The TUI Guide tab now prefers GUIDE.en.md / GUIDE.md and falls back to README files for compatibility.

Requirements

• Windows
• Outlook Classic (not New Outlook)
• Outlook must stay open while running

License

GPL-3.0-or-later. See LICENSE.