email-to-calendar 20260505142756.dev0

Takes emails from an IMAP server, parses the body, and creates event(s) in a CalDAV calendar

E-Mail to calendar Converter

The point of this application is to search an IMAP account, look for emails based on certain criteria(s), and parse the content, using regex, and automatically create calendar events in an iCal account.

TO-DO

• Get e-mails, and save ID to sqlite db to avoid duplicates
• Save calendar events to sqlite db to avoid duplicates
• Add config to backfill (check all emails from an optional certain date), or use most recent email
  • If using most recent, when new email arrives, remove events not present, and add new ones
• If new email comes in with updated events, update event in calendar instead of creating a new one
• Using email summary check for words like Cancelled, etc. to delete events
• If event already exists, check if details have changed, and update if necessary
• Investigate IMAP IDLE (push instead of poll)
• Make sure all day events are handled correctly
• Add Docker Model Runner support
• Add 'validate' function for events, and if it fails, have AI re-process that event

Environment Variables

Name	Description	Type	Default Value	Allowed Values