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)

• undocumented-modules-analysis — snapshot audit of modules lacking notes-system documentation, with priority tiers

• estate-agent-mail-access — Why the estate agent's viewing emails need the existing Outlook POP3 pipeline rather than a Claude connector, and options for querying the mail store

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

version 10  ·  updated 2026-09-05