mes-courriels 0.0.3

A Python mail connector library

mail_connector

Gmail connector for Python — read, modify, and organize emails via OAuth2.

Installation

pip install mes-courriels

Setup

1. Create a Google Cloud project and enable the Gmail API
2. Create an OAuth2 Client ID (type Desktop)
3. Copy .env.example to .env and fill in GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET
4. Run the auth script to get a refresh token:

uv run python scripts/auth.py

Usage

from mail_connector import GmailConnector

gmail = GmailConnector()

gmail.list_labels()
gmail.list_messages(query="from:[e-mail]")
gmail.get_message("msg_id")

gmail.mark_as_read("msg_id")
gmail.mark_as_unread("msg_id")
gmail.archive("msg_id")
gmail.trash("msg_id")
gmail.modify_message("msg_id", add_label_ids=["STARRED"])

CLI

mes-courriels [e-mail]              # 10 derniers messages
mes-courriels [e-mail] -n 3         # les 3 derniers
mes-courriels [e-mail] -w           # surveiller en continu (60s)
mes-courriels [e-mail] -w -i 30     # surveiller toutes les 30s

Development

• Python >= 3.12, uv

uv sync
uv run pytest