Paperless-ngx MCP Server with 26 Tools for Claude, Cursor, and AI Agents
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.
Ask AI about this server
Compatible with every major AI agent and IDE

* 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)
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


















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.
Create correspondent on Paperless-ngx
Create a new correspondent
Create document type on Paperless-ngx
Create a new document type
Create saved view on Paperless-ngx
Create a new saved view
Create tag on Paperless-ngx
Create a new tag
Delete correspondent on Paperless-ngx
Delete a correspondent
Delete document on Paperless-ngx
Delete a document
Delete document type on Paperless-ngx
Delete a document type
Delete saved view on Paperless-ngx
Delete a saved view
Delete tag on Paperless-ngx
Delete a tag
Download document on Paperless-ngx
Download the actual document file
Get correspondent on Paperless-ngx
Retrieve correspondent details
Get document on Paperless-ngx
Retrieve details of a specific document
Get document type on Paperless-ngx
Retrieve document type details
Get tag on Paperless-ngx
Retrieve tag details
List correspondents on Paperless-ngx
List all correspondents
List document types on Paperless-ngx
List all document types
List documents on Paperless-ngx
Supports filtering and searching via query parameters. List all documents in Paperless-ngx
List saved views on Paperless-ngx
List all saved views
List tags on Paperless-ngx
List all tags
Preview document on Paperless-ngx
Get a preview of the document
Thumb document on Paperless-ngx
Get the document thumbnail
Update correspondent on Paperless-ngx
Update a correspondent
Update document on Paperless-ngx
Update document metadata
Update document type on Paperless-ngx
Update a document type
Update tag on Paperless-ngx
Update a tag
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_documentswith 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 withdownload_document, or get instant visual context withpreview_documentandthumb_document. - Metadata Management — Organize your library by creating and updating tags, correspondents, and document types using dedicated tools like
create_tagorupdate_correspondent. - Deep Inspection — Fetch complete OCR text and metadata for any specific file using
get_documentto 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.
More in this category

Notion Calendar (formerly Cron)
10 toolsManage scheduling via Notion Calendar — create events, track team availability, and manage scheduling links directly from any AI agent.

Upstash
23 toolsManage serverless Redis via Upstash REST API — execute commands, manage data structures and monitor your database from any AI agent.

Miro
14 toolsManage Miro boards, items and comments via API — create boards, add sticky notes, browse items and manage members from any AI agent.

GitHub
12 toolsManage repositories, track issues, and search code via AI agents with GitHub.
You might also like

American Airlines
3 toolsAI flight tracking: check flight status, schedules, and airport info via agents.

Contentdrips
10 toolsTurn text into scroll-stopping social media carousels and visual content pieces that boost engagement on every platform.

Icypeas
10 toolsLead generation and email verification via Icypeas API.

SaveDay
4 toolsCapture, organize, and summarize content from URLs, text, and images directly into your SaveDay knowledge base.
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.
Hosted, sandboxed, and live on AWS. You don't provision anything. You don't maintain anything. You connect.
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.
Eight governance layers on every request. Sensitive data redacted before it reaches the model. Kill switch if anything goes sideways. Always on.
