[Show and tell] roundcube-paperless-attach – attach Paperless-ngx documents from Roundcube webmail

[dodjango]

I built a small Roundcube plugin that brings Paperless-ngx into the mail compose window: attach documents from Paperless-ngx directly while writing an email — no downloading and re-uploading.

My typical use case: I am replying to an email and want to attach a document I already have in Paperless. I hit "Attach from Paperless", search, pick, send.

What it does

• "Attach from Paperless" button in the Roundcube compose window
• Search & filter by tags, correspondent, document type and date
• Selected documents are fetched server-side and attached to the outgoing mail

Notes on security / design

• The Paperless API token is stored encrypted, per user
• The browser never sees the token or the Paperless base URL — all Paperless traffic is server-side (SSRF guards, integer-validated document IDs)
• Roundcube 1.6 (Elastic skin) only, PHP 7.4+

Install: composer require dodjango/paperless_attach
Code & docs (GPL-3.0): https://github.com/dodjango/roundcube-paperless-attach

I use it regularly and would love feedback — issues and PRs welcome.