{"repo":"jeremyephron/simplegmail","free":true,"listed":false,"github":"https://github.com/jeremyephron/simplegmail","clone":"git clone https://github.com/jeremyephron/simplegmail.git","description":"A simple Gmail API client for applications in Python","language":"Python","stars":407,"topics":["api","python3","gmail","gmail-api","email","pypi-package","python"],"license":"MIT","category":"auth-billing-email","readme_excerpt":"simplegmail A small Python client for sending, retrieving, and modifying messages through the Gmail API. simplegmail supports: - plain-text and HTML messages; - file attachments, Cc, Bcc, aliases, and Gmail signatures; - standard-library EmailMessage objects, drafts, and threaded replies; - Gmail search queries and common inbox filters; - lazy or eager attachment downloads; and - label changes such as read/unread, star/unstar, archive, spam, and trash. Requirements and installation simplegmail requires Python 3.10 or newer. Google OAuth setup Before using the library, create OAuth desktop credentials for a Google Cloud project: 1. Create or select a project in the Google Cloud console. 2. Enable the Gmail API. 3. Configure the OAuth consent screen. 4. Create an OAuth client ID with the application type Desktop app . 5. Download the client JSON as client secret.json into your application directory. Google's Gmail Python quickstart contains the current console instructions. The first Gmail() call opens a browser for authorization and stores the result in gmail token.json : Both paths are configurable: Treat both files as secrets and never commit them. When an external OAuth app has the publishing status Testing , Google may expire its authorization and refresh token after seven days. For long-running use, change the consent screen's publishing status to Production , delete the old token file, and authorize again. See Google's OAuth audience documentation for the applicable requ","default_branch":null,"files":null,"tree":[],"storefront":"/r/jeremyephron","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/jeremyephron/simplegmail/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}