mailsort

Assign labels to emails on any IMAP mail server based on their similarity to other emails already assigned to the same label.

mailsort connects to a mail account over plain IMAP, trains a machine learning model on the labels (IMAP folders) you have already assigned, and uses that model to suggest or apply labels to new messages. It has no dependency on Google APIs - for Gmail-specific features (OAuth, the Gmail label API, the sorting daemon and web UI) see gmailsorter, which depends on mailsort for the shared IMAP and machine learning core.

Installation

pip install mailsort

Command line interface

mailsort --host imap.example.com --username user@example.com -u
mailsort --host imap.example.com --username user@example.com -l "some_label"

The IMAP password is read from the IMAP_PASSWORD environment variable (configurable with --password-env).

Python interface

from mailsort import Imap

imap = Imap(
    host="imap.example.com",
    port=993,
    username="user@example.com",
    password="...",
    connection_str="sqlite:///email.db",
)
imap.update_database(quick=False)
imap.fit_machine_learning_model_to_database()
imap.filter_messages_from_server(label="some_label", recommendation_ratio=0.9)