Skip to main content

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/ (for this RC: docs/releases/evidence/0.4.0-rc2.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).

Screenshots

Home Run Configuration Plugin Editor

Plugin Capability Matrix

Plugin Primary purpose LLM required Typical output
add_category Classify emails and add categories Yes Outlook category tags
move_to_folder Decide and move target folders Yes Folder move result
create_appointment Create calendar items from email content Yes Outlook calendar items
event_table Extract event data into a table Yes output/events.xlsx
summary_file Generate summaries and priorities Yes output/email_summaries.csv
write_file Export raw email data No output/*.json

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.

Metadata

Release files for mailslide 0.4.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mailslide 0.4.2
File Size Uploaded
mailslide-0.4.2.tar.gz 131.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mailslide 0.4.2
File Interpreter ABI Platform
mailslide-0.4.2-py3-none-any.whl Python 3 none any Details

Total release size: 302.6 kB

Release files / mailslide-0.4.2.tar.gz

Download URL mailslide-0.4.2.tar.gz
Size 131.6 kB
Tags Source
SHA-256 checksum
How to use checksums
83ca08b6f45d6ded6985e3c3ee524c8ff2efd6681850becdc0e97a8099357c0e
BLAKE2b-256 checksum
How to use checksums
6880ab0880f9835ca63281ad3bd59ca34816add138d80eed332b35dc3f4c2ab6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 2, 2026.

Transparency log

Release files / mailslide-0.4.2-py3-none-any.whl

Download URL mailslide-0.4.2-py3-none-any.whl
Size 171.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3261985eb258c16a7feaa67a06f6751533919e8f45f78e56d52804d8641cce23
BLAKE2b-256 checksum
How to use checksums
b10526858f13f3a22c818679e5a53d12c312f072791a3fb9447d65430811d887
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 2, 2026.

Transparency log

Release history Release notifications | RSS feed

0.5.0

2 release files

This release

0.4.2 This release

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.10

2 release files

0.3.9

2 release files

0.3.8

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page