PopIt3 - Intelligent Email Processing Pipeline

A modular email processing system that routes incoming emails to specialized handlers based on recipient address. Supports job analysis, gym bookings, autonomous AI agent operations, and spam filtering.

Email Routing

john.js@critchley.biz → newparser_jobserve (job analysis)

john.dl@critchley.biz → MyDavidLloydSchedule (gym bookings)

envoy@critchley.biz → mailspool/WebDAV (AI agent)

See linked documentation for details.

Operations

Re-authentication URLs — quick reference for when Google or Outlook tokens expire

Documentation

Architecture — System design

Mail Filters — Filter logic

Email Routing — Dispatcher

Envoy Agent — AI agent operations

google-auth — OAuth2 WSGI script: renews Google token (Calendar/Gmail/Drive) via browser auth flow; visit /google

msauth — OAuth2 WSGI script: acquires Outlook POP refresh token via browser auth flow

msauth-proxy — WSGI shim that loads and auto-reloads the msauth script

outlook-token-renewal — current Outlook OAuth flow (device flow, supersedes msauth below); renewal, WebDAV token storage, popit3.py auto-recovery, troubleshooting

ops — Operational reference: logs, databases, HTML report, troubleshooting (locked DB, auth failures, WebDAV, OpenAI errors, stuck/hung popit3.py process)

todo — Active task list: completed work log and open ideas

version 9  ·  updated 2026-06-25