Paperless Telegram Bot

Telegram bot for managing your Paperless-ngx document archive — upload documents by sending files or photos, search your archive, tag documents, and organize…

  • Productivity
  • Tools & Utilities
Telegram bot for managing your Paperless-ngx document archive — upload documents by sending files or photos, search your archive, tag documents, and organize your inbox, all from Telegram without accessing the web UI. Features a health check endpoint, user whitelisting, and auto-detection of inbox tags.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

67/100 Good

Maintained
98last commit 14 days ago
Popular
2415 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
701 GB minimum RAM
Security check
89no serious findings, 1 minor, CI, tests

Availability: platform listings confirmed today, links checked 30 days ago

GitHub stars
15
Open issues
0
Last commit
2026-11-06
Latest release
v0.7.2
License
GPL-3.0
Activity
declining

Checked 9 days ago - source: GitHub (GeiserX/paperless-telegram-bot)

Resources & Compatibility

Minimum requirements: 1 GB RAM, 1 CPU core(s), 20 GB disk. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Setup Requires a running Paperless-ngx instance and a Telegram bot token. Configure via Docker Compose with a .env file containing TELEGRAM_BOT_TOKEN, PAPERLESS_TOKEN, and TELEGRAM_ALLOWED_USERS (start from .env.example). source

Fetched 45 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How should I set the Paperless address when running the bot and Paperless in Docker?

Use the host's LAN address, or use the Paperless container name when both share a Docker network.

How can I tell that the bot has started successfully?

The log should end with Bot commands registered with Telegram. Sending /start to the bot in Telegram should return the command list.

Can I upload documents to Paperless by sending them in Telegram?

Yes, the bot can act as a Paperless consumer. It copies documents uploaded via Telegram into the Paperless consume folder.

Can I use it from my phone without the Paperless web UI?

Yes, it integrates with Paperless-NGX and lets you manage documents from a phone or desktop without the web UI.

Answers sourced from github.com, github.com, www.reddit.com

Community

Collected 48 days ago - public community threads