dsh-email-reader

Since September 2024 Microsoft has cut off basic username-and-password IMAP authentication for personal Outlook.com accounts, leaving OAuth2 as the only supported channel. Most existing mail plugins still depend on plain passwords, which leaves Outlook users unable to have their models read email at all. dsh-email-reader plugs exactly that gap: it lets a DeepSeek Harness model access Outlook or any other IMAP mailbox through a secure OAuth2 flow.

The plugin exposes three model-callable tools. ol_email_list returns recent inbox messages with sender, subject, date, and flags; ol_email_read fetches a single message in full and auto-parses the MIME body; ol_email_search performs server-side IMAP full-text search ordered newest first. Authentication accepts a refresh token plus client ID to obtain an access token automatically, and also falls back to a conventional password or app-specific password for providers that still allow it. An optional HTTP or SOCKS proxy setting covers environments where direct access to overseas mail services is blocked by campus or corporate firewalls. Every tool supports an accounts array for multi-account switching and returns a uniform ok field, so a misconfiguration simply yields an error payload instead of throwing an exception into the host session.

The plugin is best suited for three groups: individuals whose primary mailbox is Outlook and who are now forced onto OAuth2 by Microsoft; users on campus or corporate networks that require a proxy to reach Gmail or other foreign mail services; and power users who want to juggle several mailboxes inside one Harness. Tool names carry the ol_ prefix, so the plugin coexists cleanly with the market dsh-email plugin (email_ prefix)—install both and let each handle its own mailbox.