4,000+ servers built on vurb.ts
Vinkius
Paperless-ngx

Paperless-ngx MCP Server with 26 Tools for Claude, Cursor, and AI Agents

MCP Inspector GDPR Free for Subscribers

Manage your digital archive via Paperless-ngx — search documents, upload files, manage tags, and organize correspondents directly from any AI agent. Vinkius routes your AI agents directly to Paperless-ngx through a governed connection. 26 tools ready to use with Claude, ChatGPT, Cursor, or any AI agent — no hosting, no setup, connect in 30 seconds.

Built for AI Agents by Vinkius

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
AI AgentVinkius
High Security·Kill Switch·Plug and Play
Paperless-ngx
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

What is the Paperless-ngx MCP Server?

The Paperless-ngx MCP Server routes AI agents like Claude, ChatGPT, and Cursor directly to Paperless-ngx via 26 tools. Manage your digital archive via Paperless-ngx — search documents, upload files, manage tags, and organize correspondents directly from any AI agent. Powered by Vinkius — your credentials stay on your side of the connection, every request is auditable. Connect in under 2 minutes.

Built-in capabilities (26)

create_correspondentcreate_document_typecreate_saved_viewcreate_tagdelete_correspondentdelete_documentdelete_document_typedelete_saved_viewdelete_tagdownload_documentget_correspondentget_documentget_document_typeget_taglist_correspondentslist_document_typeslist_documentslist_saved_viewslist_tagspreview_documentthumb_documentupdate_correspondentupdate_documentupdate_document_typeupdate_tagupload_document

Tools for your AI Agents to operate Paperless-ngx

Ask your AI agent "Search for all documents related to 'Electricity Bill' from 2023." and get the answer without opening a single dashboard. With 26 tools connected to real Paperless-ngx data, your agents reason over live information, cross-reference it with other MCP servers, and deliver insights you would spend hours assembling manually.

Works with Claude, ChatGPT, Cursor, and any MCP-compatible client. Powered by Vinkius — your credentials never touch the AI model, every request is auditable. Connect in under two minutes.

Why teams choose Vinkius

One subscription gives you the infrastructure to connect your AI agents to thousands of MCP servers — and deploy your own to the Vinkius Edge. Your credentials stay yours. Your data flows directly between your agent and the API. DLP blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade routing and governance, zero maintenance.

Build your own MCP Server with our secure development framework →

The Paperless-ngx App Connector works with every AI agent you already use

…and any MCP-compatible client

CursorClaudeOpenAIVS CodeCopilotGoogleLovableMistralAWSCursorClaudeOpenAIVS CodeCopilotGoogleLovableMistralAWS

Use all 26 Paperless-ngx tools with your AI agents right now

Vinkius routes your AI agents to Paperless-ngx through a governed proxy. Beyond a simple connection, you get full visibility into every action your agents perform, with enterprise-grade security and up to 60% savings on AI costs.

Explore Tools Hub
create

Create correspondent on Paperless-ngx

Create a new correspondent

create

Create document type on Paperless-ngx

Create a new document type

create

Create saved view on Paperless-ngx

Create a new saved view

create

Create tag on Paperless-ngx

Create a new tag

delete

Delete correspondent on Paperless-ngx

Delete a correspondent

delete

Delete document on Paperless-ngx

Delete a document

delete

Delete document type on Paperless-ngx

Delete a document type

delete

Delete saved view on Paperless-ngx

Delete a saved view

delete

Delete tag on Paperless-ngx

Delete a tag

download

Download document on Paperless-ngx

Download the actual document file

get

Get correspondent on Paperless-ngx

Retrieve correspondent details

get

Get document on Paperless-ngx

Retrieve details of a specific document

get

Get document type on Paperless-ngx

Retrieve document type details

get

Get tag on Paperless-ngx

Retrieve tag details

list

List correspondents on Paperless-ngx

List all correspondents

list

List document types on Paperless-ngx

List all document types

list

List documents on Paperless-ngx

Supports filtering and searching via query parameters. List all documents in Paperless-ngx

list

List saved views on Paperless-ngx

List all saved views

list

List tags on Paperless-ngx

List all tags

preview

Preview document on Paperless-ngx

Get a preview of the document

thumb

Thumb document on Paperless-ngx

Get the document thumbnail

update

Update correspondent on Paperless-ngx

Update a correspondent

update

Update document on Paperless-ngx

Update document metadata

update

Update document type on Paperless-ngx

Update a document type

update

Update tag on Paperless-ngx

Update a tag

upload

Upload document on Paperless-ngx

Upload a new document

What the Paperless-ngx MCP Server unlocks

Connect your Paperless-ngx instance to any AI agent and transform your document archive into a searchable, conversational knowledge base.

What you can do

  • Document Discovery — Use list_documents with full-text search or filter by tags and dates to find exactly what you need in seconds.
  • File Operations — Upload new documents with upload_document, download originals with download_document, or get instant visual context with preview_document and thumb_document.
  • Metadata Management — Organize your library by creating and updating tags, correspondents, and document types using dedicated tools like create_tag or update_correspondent.
  • Deep Inspection — Fetch complete OCR text and metadata for any specific file using get_document to help your AI analyze contents.
  • Saved Views — Access your predefined filters and organizational structures with list_saved_views.

How it works

1. Subscribe to this server
2. Provide your Paperless-ngx API URL and Personal API Token
3. Start chatting with your documents in Claude, Cursor, or any MCP-compatible client

No more manual searching through folders. Your AI acts as a digital librarian that knows every word in your archive.

Who is this for?

  • Home Office Users — instantly find utility bills, tax records, or manuals without digging through physical or digital piles.
  • Legal & Admin Teams — query specific correspondents or document types to build reports or verify information quickly.
  • Researchers — manage large collections of PDFs and papers with automated tagging and content retrieval.

Frequently asked questions about the Paperless-ngx MCP Server

Can I search for documents using specific tags or date ranges?

Yes. The list_documents tool allows you to filter by tags__id__in and created__date__gte. You can also perform a full-text search using the query parameter.

Is it possible to see a preview of a document without downloading the whole file?

Absolutely. Use the preview_document or thumb_document tools to get visual representations of the document content directly through the agent.

Can I create new organization categories like tags or correspondents via AI?

Yes, you have full management capabilities. You can use create_tag, create_correspondent, and create_document_type to organize your archive on the fly.

Vinkius AI Gateway

We built the connector to Paperless-ngx. Now put your agents to work. Fully governed.

Vinkius is the AI Gateway with managed hosting. Stop building connectors. Every connection runs inside eight layers of security.

How it works
Infrastructure

Hosted, sandboxed, and live on AWS. You don't provision anything. You don't maintain anything. You connect.

Visibility

Every tool call, every token, every response. Logged and auditable. Data flows direct from Paperless-ngx to your agent. Nothing is stored on our side. Ever.

Control

Eight governance layers on every request. Sensitive data redacted before it reaches the model. Kill switch if anything goes sideways. Always on.