# paperless-gpt

> AI that titles and tags your Paperless-ngx documents.

- Page: https://cgt.octabyte.io/templates/paperless-gpt/
- Category: AI
- Ease of use: Some setup. Enter your Paperless-ngx address and API token and your AI provider's key, then tag documents in Paperless-ngx for it to process.
- App price: Free. To run it you need Cloudgate (hosted, or free to install yourself) and a server, which hosted Cloudgate can provide.
- License: MIT
- Good for: Paperless-ngx users who want AI to title, tag and file new documents
- Official website: https://github.com/icereed/paperless-gpt
- Documentation: https://github.com/icereed/paperless-gpt#readme
- Source code: https://github.com/icereed/paperless-gpt
- Last updated: 2026-11-20

## What is paperless-gpt?

paperless-gpt is a self-hosted AI add-on for Paperless-ngx that suggests titles, tags and dates for your documents and re-reads poor scans.

paperless-gpt is a free, open-source, self-hosted add-on that brings AI to Paperless-ngx: it suggests titles, tags, senders, dates and custom fields for your scanned documents, and can re-read poor scans with an AI model. It works with the document archive you already run and changes nothing until you approve it, unless you choose automatic mode.

You tag documents in Paperless-ngx, and paperless-gpt picks them up, asks the AI model you chose, and shows its suggestions in its own web page for you to check and apply. It can also link related papers, such as a payment reminder and the invoice it refers to. A small accounting office, for example, could tag each morning's scans and have them titled "Electricity bill March 2026", tagged and dated in a few clicks.

You choose the AI: OpenAI, Anthropic, Mistral, Google Gemini, or Ollama to keep everything on your own hardware. With a cloud provider, the text of each processed document is sent to it.

Cloudgate installs paperless-gpt on a server Cloudgate provides or one you connect, puts a password prompt in front of it and gives it a secure web address. You need a running Paperless-ngx, such as the one in this catalogue, and its API token.

## What you can do with paperless-gpt

- **Get titles and tags written for you**: An AI model reads each document and suggests a title, tags, the sender and the date it was written.
- **Review before anything changes**: Check and edit each suggestion in paperless-gpt's web page, or let it apply them automatically.
- **Fill in your custom fields**: It can read amounts, due dates or account numbers from a document into your Paperless-ngx custom fields.
- **Link documents that belong together**: A reminder is linked to the invoice it cites, or an amendment to its contract, and unclear cases are left alone.
- **Make hard-to-read scans readable**: Optionally, an AI model that reads images re-reads poor scans for cleaner, searchable text.
- **Choose your AI**: Use OpenAI, Anthropic, Mistral or Google Gemini, or Ollama to run a model on your own hardware.
- **Tune it to your paperwork**: Edit the instructions the AI follows for titles, tags and other fields, right in the web page.

## What happens when you click Deploy?

Deploy link: https://cloudgate.octabyte.app/get-started?template=paperless-gpt

1. **Click Deploy and create your account.** Deploy takes you to Cloudgate. Create an account, or log in if you have one. paperless-gpt itself is free.
2. **Choose a server.** No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
3. **Cloudgate sets up paperless-gpt.** It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
4. **Open your app and sign in.** Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

## Questions

### Is paperless-gpt free?

Yes, paperless-gpt is free and open source under the MIT licence. Your AI provider charges for what it processes, unless you run your own models with Ollama.

### Do I need Paperless-ngx to use paperless-gpt?

Yes. paperless-gpt is an add-on that reads and updates documents in a Paperless-ngx you already run, through its address and API token. It does not store documents itself. It is a separate project, not made by the Paperless-ngx team.

### Which AI services does paperless-gpt work with?

paperless-gpt works with OpenAI, Anthropic, Mistral and Google Gemini, and with Ollama for models you run yourself. You choose the provider and model when you set it up.

### Do my documents leave my server with paperless-gpt?

Yes, with a cloud AI provider. paperless-gpt sends the text of each document it processes to that provider, and page images too if AI scan reading is on. With Ollama on your own hardware, nothing leaves your servers.

### How do I use paperless-gpt day to day?

In Paperless-ngx, add the tag paperless-gpt to documents you want to review, or paperless-gpt-auto to have suggestions applied automatically. Then open paperless-gpt's web page to check and apply the suggestions.

### How do I sign in to paperless-gpt?

paperless-gpt has no accounts of its own, so Cloudgate puts a password prompt in front of it. Sign in with the username admin and the password shown in the app's settings in Cloudgate.

### Can paperless-gpt read bad scans?

Yes, if you give paperless-gpt an AI model that can read images. It then re-reads scanned pages with that model, which often copes better with faint or messy scans than standard text recognition.

### Do I need technical skills to run paperless-gpt?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up paperless-gpt and gives it a web address. You use it in your browser like any other online tool.

### Do I need my own server for paperless-gpt?

No. When you deploy paperless-gpt, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
