icutool/microsoftemailmanage

This project is a self-hosted management dashboard for handling many Hotmail and Outlook email accounts at once. Instead of logging into each mailbox one at a time, you run this tool on your own computer or server and manage every account from a single web page. It is aimed at people or small teams who need to keep track of a large number of email accounts, rather than at building a full email client. The main features are bulk importing accounts by pasting a list where each line contains the email address, password, client ID, and refresh token, tagging accounts with labels so they can be filtered by purpose or status, adding free text notes to each account for extra context, and viewing inbox and spam folder contents directly from the dashboard. A built in scheduler automatically refreshes each account's OAuth access token every day at 3 AM server time, which keeps the accounts connected to Microsoft's mail servers without manual work. Every refresh run is logged with success and failure counts, error details, and how long it took, and older refresh tokens are kept in a history table so changes can be traced later. The technology stack is Python based: FastAPI serves the backend API, Jinja2 renders the HTML pages, SQLite stores everything in one local file so no separate database server is needed, and IMAP with XOAUTH2 is used to talk to the mail servers. The dashboard is protected by a single admin password set through an environment variable, with a default password if none is set. The README states plainly that this login setup is lightweight and meant for local, trusted, or internal network use, not public internet exposure. Getting started requires installing Python dependencies and running one command.