I quickly found the reddit_api python module, now called PRAW (Python Reddit API Wrapper), but it didn’t quite do what I wanted. [*Disclaimer: This might not be true with newer versions of PRAW]So I forked it.
My changes include a direct way to access reddits unread message end-point.

With that in hand, we can build a script to check our unread messages.