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.1

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.1
File Size Uploaded
gmailsorter-0.2.1.tar.gz 1.4 MB Details

Built distribution (wheel)

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

Total release size: 2.7 MB

Release files / gmailsorter-0.2.1.tar.gz

Download URL gmailsorter-0.2.1.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
880a3f39794a3a4f28768c9ce251c51391888c5dd5a5a145bbea0a6cac8a0301
BLAKE2b-256 checksum
How to use checksums
4f0c72b6157b14e98b94d8ec4e7bead3d0b549763ca7764ffe7762a096e85d68
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 12, 2026.

Transparency log

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

Download URL gmailsorter-0.2.1-py3-none-any.whl
Size 1.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
157c76a71ca396b2404353a79a09e90c326ecd73f47f70a177ea0729d3655e1a
BLAKE2b-256 checksum
How to use checksums
0cdcb4c7e3b35da6f41eb75bba0e9694d106bf345375ed6623b3f3961cda8488
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 12, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 release files

0.2.0

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