Skip to main content

Extract, analyze, and automate Outlook Classic emails on Windows, with optional LLM-powered plugins.

Project description

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.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mailslide-0.4.1.tar.gz (126.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mailslide-0.4.1-py3-none-any.whl (166.0 kB view details)

Uploaded Python 3

File details

Details for the file mailslide-0.4.1.tar.gz.

File metadata

  • Download URL: mailslide-0.4.1.tar.gz
  • Upload date:
  • Size: 126.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mailslide-0.4.1.tar.gz
Algorithm Hash digest
SHA256 018857617a1554677a504de94203a3018e8f3d8014678e31de6162d2cba2ab0e
MD5 a25cafa6d8b62c2eb9c3879a7bc2ddb2
BLAKE2b-256 db3fc547bd5daa05e2169418129f395bed3e57e61b4a6d7b34798ecf52036243

See more details on using hashes here.

Provenance

The following attestation bundles were made for mailslide-0.4.1.tar.gz:

Publisher: publish-pypi.yml on linax777/mailslide

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mailslide-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: mailslide-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 166.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mailslide-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 04ab0cddaa0fcf151734cce6ee1c1d2bbd20de2309f5c7a4c353c3948fc26bc8
MD5 d778f0677c2f9142cdc7d25471b946cf
BLAKE2b-256 e73cf3fed7c1138746692ad41cb1305938e5f7a713e23b871ae2ff5d880d4e23

See more details on using hashes here.

Provenance

The following attestation bundles were made for mailslide-0.4.1-py3-none-any.whl:

Publisher: publish-pypi.yml on linax777/mailslide

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page