# Paperless Telegram Bot

Paperless Telegram Bot is a self-hosted productivity app. 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. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2210/paperless-telegram-bot

## Description

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.

## Health score

67/100 (Good), based on 5 of 5 factors.
- Maintained: 98 (last commit 14 days ago)
- Popular: 24 (15 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)
- Security check: 89 (no serious findings, 1 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/drumsergio/paperless-telegram-bot
- Official website: https://geiserx.github.io/paperless-telegram-bot
- Unraid: https://ca.unraid.net/apps/paperless-telegram-bot-0vsbr1e0hsfsxa?q=paperless-telegram-bot

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2210/paperless-telegram-bot), the self-hosted and open-source app directory.
