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.0.tar.gz (117.6 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.0-py3-none-any.whl (155.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mailslide-0.4.0.tar.gz
  • Upload date:
  • Size: 117.6 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.0.tar.gz
Algorithm Hash digest
SHA256 d7e30adc328c46366674075f9f00c8785b85f41126083c1d9e00dccc5f49cc29
MD5 5178f91d8a3a7c2537bf43681026358a
BLAKE2b-256 0426fcfe00517d7ead5766a396c6759edd1f531edc5d5ae3873bd85ddab1c5e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for mailslide-0.4.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: mailslide-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 155.8 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e71f34f4e2f93807d5145b941cfc720daffae899ddd932599d30cc50f54b931e
MD5 8375b4f085ba66c7d791bca6f6510189
BLAKE2b-256 97852a4fe43cb4fa227ff2988fddff5377d896c09ac943f4e8167a8d09fa09f2

See more details on using hashes here.

Provenance

The following attestation bundles were made for mailslide-0.4.0-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