{"repo":"martinrusev/imbox","free":true,"listed":false,"github":"https://github.com/martinrusev/imbox","clone":"git clone https://github.com/martinrusev/imbox.git","description":"Python IMAP for Agentic Workflows","language":"Python","stars":1217,"topics":["imap","agents","automation","python","workflows"],"license":"MIT","category":"workflow-automation","readme_excerpt":"Imbox - Python IMAP Library for Agentic Workflows Python library for reading IMAP mailboxes and converting email content to machine readable data Table of Contents - Requirements - Installation - CLI Usage - Running with uv - Configuration - Messages Command - Folders Command - Debugging - Usage (Python Library) Requirements Python (3.11, 3.12, 3.13) Installation pip install imbox CLI Usage Imbox includes a command-line interface that can be used to fetch emails directly from the terminal and saving the results to a JSON file. This is particularly useful for agentic workflows. Running with uv The recommended way to run the CLI is with uv: Configuration The CLI reads configuration from environment variables: Variable Description Default ---------- ------------- --------- IMBOX IMAP URL IMAP server URL imap.gmail.com IMBOX USERNAME IMAP username - IMBOX PASSWORD IMAP password or app password - IMBOX SSL Enable SSL true IMBOX PORT IMAP port 993 IMBOX STARTTLS Enable STARTTLS false DEBUG Enable debug logging false LOG LEVEL Logging level INFO LOG OUTPUT TYPE Output format. Clean displays only email fields. Default includes imbox metadata ( default or clean ) default OUTPUT Enable file output false OUTPUT FOLDER Output folder for downloaded messages output OUTPUT FILENAME Output filename for results imbox results.json Messages Command Fetch messages with optional filters: Folders Command List all folders on the IMAP server: Debugging Enable debug output for troubleshooting: Usage ","default_branch":null,"files":null,"tree":[],"storefront":"/r/martinrusev","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/martinrusev/imbox/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."}