Give Your Claude an Email Mailbox - hook bundle
================================================

Files:
  _config.py            - shared config reader; every hook resolves creds via this.
  config.example.ini    - copy to config.ini and fill in your values (gitignore it).
  email_check_hook.py   - read the inbox over IMAP (list_latest()).
  email_hook.py         - send mail over SMTP.
  forwardemail_hook.py  - manage Forward Email aliases + send via their API.
  email_instructions.md - drop this next to the hooks so your Claude knows it has
                          a mailbox and how to use it.

Setup:
  1) pip install requests        (forwardemail_hook.py needs it; the rest are stdlib)
  2) cp config.example.ini config.ini   and fill in [smtp] / [imap] / [forwardemail]
  3) python email_check_hook.py  -> prints your latest inbox messages as JSON

Forward Email (the forwarding service this uses): https://forwardemail.net
Their REST API docs: https://forwardemail.net/en/email-api
Full write-up: https://codingwith.org/articles/give-your-claude-an-email-mailbox

No warranty; you run these against your own accounts. Never commit config.ini.
