Skip to main content

Gmailsorter - Similarity based email sorting for Google Mail

Python package codecov Code style: black

gmailsorter provides the Gmail-specific parts (Gmail API, OAuth, the sync daemon and web UI) and depends on mailsort for the shared IMAP client and machine learning core, which has no Google dependencies and can also be used on its own to sort emails on any IMAP mail server.

Update

gmailsorter.com web service launched as private beta - request access now: first login

Motivation

In 2020 there were 306.4 billion e-mails sent and received daily. This number is estimated to increase by 4% yearly, resulting in over 376.4 billion e-mails by 2025 . While email as medium for internal communication in large enterprises is slowly replaced by instant messaging solutions and business communication platforms, these solutions fail to address the primary challenge, namely the communication between employees from different companies. So addressing the stress and productivity lost resulting from interruptions caused by the increase of daily emails is the motivation for the development of gmailsorter.

Features

As a first step gmailsorter creates a barrier between you and your email. Just like a personal guardian it blocks emails from your inbox and filters them into categories, so you can read the emails you care about when you have time and no longer have them interrupt your work. Second in contrast to other automated solutions, gmailsorter is designed to seamlessly integrate into your existing workflow:

  • Gmailsorter is a server-side application, so you can continue using your favorite email client. In addition, the Gmailsorter user interface is minimalistic so you can configure it once and then forget about it.
  • Gmailsorter adopts the email labels you suggest and filters your emails accordingly. It is based on the believe that the structure how you sort your ideas, documents and emails is very personal and you know what works best for you.
  • Gmailsorter learns from your reactions. When you disagree with a suggested email label and modify it, Gmailsorter takes this feedback into account for the next suggestions.

So you can think about gmailsorter like a virtual assistant. It learns how you want your emails to be sorted based on their similarity to previous emails you assigned to the same label. All the communication with gmailsorter is handled via your Google Mail account. Following there simple steps:

  • Gmailsorter takes your new emails and moves them from your inbox to its inbox.
  • Afterwards Gmailsorter compares who sent the email, who else received it and which thread and labels it is associated with to your previously sorted emails, and based on that predicts the email label for the new email.
  • If you agree with this suggestion you do have to do anything. But if you disagree with the suggestion, you can simply change the email label, on the one hand this overwrites the suggestion from Gmailsorter and on the other hand Gmailsorter takes your modification into account when it retrains its model for making suggestions.

To learn more about Gmailsorter please have a look at the documentation below.

Documentation

License

gmailsorter is released under the BSD license https://github.com/jan-janssen/gmailsorter/blob/main/LICENSE .

Metadata

Release files for gmailsorter 0.2.0

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

Source distribution (sdist)

Source distribution for gmailsorter 0.2.0
File Size Uploaded
gmailsorter-0.2.0.tar.gz 1.4 MB Details

Built distribution (wheel)

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

Total release size: 2.7 MB

Release files / gmailsorter-0.2.0.tar.gz

Download URL gmailsorter-0.2.0.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
2be9e2b3ffb65f6c333a21c86d04ad050ba853e49eb7275d517463a12e871f1f
BLAKE2b-256 checksum
How to use checksums
0b991e60662fdfc51b2abc3d29811e9caa19e5a378444188dc2090df2bb28215
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 11, 2026.

Transparency log

Release files / gmailsorter-0.2.0-py3-none-any.whl

Download URL gmailsorter-0.2.0-py3-none-any.whl
Size 1.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d959d9a60bfc1bc75f4ddf9d511c8833ed87f96eb98898d51ab07bdeb60496bc
BLAKE2b-256 checksum
How to use checksums
e4d3641f785d515eb4aa493c9d39f9de165f7228bb42aeecaea5495614bf64cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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 Oct 11, 2026.

Transparency log

Release history Release notifications | RSS feed

0.2.1

2 release files

This release

0.2.0 This release

2 release files

0.1.10

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

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