Paperless-ngx Connector for AI agents.

26 live capabilities

Search and manage your personal document archive using natural language.

Live agent request Paperless-ngx / Connector

Waiting for input…

AI Agent

Why people use Paperless-ngx

Paperless-ngx: Turn your static document archive into a searchable brain

With this Connector, you stop digging. You just ask your agent, "Where is my car insurance?" and it scans your Paperless-ngx archive, finds the document, and tells you what's in it. You move from clicking through folders to just getting answers.

What Vinkius changes

It turns your static document archive into a conversational database.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Finding old utility bills

A user asks for all electricity bills from 2022.
Real-world use case 02

Reviewing lease agreements

A legal assistant asks to find the "termination clause" in a lease.
Real-world use case 03

Batch processing new uploads

A user wants to tag all new PDFs from a specific company.

Complete set · 26capabilities

The complete Paperless-ngx capability set.

These are the exact actions your AI can choose when you ask it to work with Paperless-ngx.

Capability set01 / 07

01—04

4 capabilities in this set.

Part of 26 available through Paperless-ngx.

01 Capability
List tags
Get a list of every tag in your archive. Use this to see how your library is currently organized.
02 Capability
List documents
Search and filter through your entire archive. Use this to find any file based on dates, tags, or keywords.
03 Capability
Create correspondent
Add a new contact or organization to your library. This helps your agent track who you interact with.
04 Capability
Delete tag
Remove a tag you no longer need. This helps keep your organizational labels clean.

Capability set02 / 07

05—08

4 capabilities in this set.

Part of 26 available through Paperless-ngx.

05 Capability
Get correspondent
See the details for a specific contact or organization. It helps your agent identify who a document belongs to.
06 Capability
Get document
Pull all the metadata and OCR text for a single file. This lets your agent read the contents of a scan.
07 Capability
Get document type
See the specific category details for a document. This helps the agent understand the nature of the file.
08 Capability
List correspondents
See a full list of all your contacts and organizations. This helps your agent identify key entities in your archive.

Capability set03 / 07

09—12

4 capabilities in this set.

Part of 26 available through Paperless-ngx.

09 Capability
List document types
See all the categories you've set up for your files. This helps your agent understand your filing system.
10 Capability
Preview document
Get a quick visual look at a document's contents. This helps you verify you've found the right file.
11 Capability
Thumb document
Grab a small thumbnail image of a document. This is perfect for quickly scanning through multiple results.
12 Capability
Update correspondent
Edit the information for a specific contact. Use this to keep your organization's directory up to date.

Capability set04 / 07

13—16

4 capabilities in this set.

Part of 26 available through Paperless-ngx.

13 Capability
Update document
Change the metadata or tags on a specific file. This allows your agent to organize your library for you.
14 Capability
Update document type
Modify the category settings for your documents. Use this to change how a file is classified in your archive.
15 Capability
Update tag
Edit the name or description of an existing tag. This keeps your organizational labels consistent.
16 Capability
Upload document
Send a new file to your Paperless-ngx instance. Use this to add new documents to your archive via chat.

Capability set05 / 07

17—20

4 capabilities in this set.

Part of 26 available through Paperless-ngx.

17 Capability
Create tag
Add a new organizational tag to your archive. This lets you create new categories as you find them.
18 Capability
List saved views
See all your custom saved search filters. Use this to see your most-frequent archive queries.
19 Capability
Create document type
Set up a new category for your documents. Use this to expand your filing system's structure.
20 Capability
Create saved view
Save a specific search filter for later use. This helps your agent jump to your most-used results quickly.

Capability set06 / 07

21—23

3 capabilities in this set.

Part of 26 available through Paperless-ngx.

21 Capability
Delete correspondent
Remove a contact from your archive. Use this to clean up your library of old or irrelevant entities.
22 Capability
Delete document
Permanently remove a file from your library. Use this to clean up your archive when a document is no longer needed.
23 Capability
Delete document type
Remove a document category. Use this to simplify your filing system.

Capability set07 / 07

24—26

3 capabilities in this set.

Part of 26 available through Paperless-ngx.

24 Capability
Delete saved view
Delete a custom saved search filter. Use this to remove filters that are no longer useful.
25 Capability
Download document
Save the actual document file to your local machine. Use this when you need the original file for offline use.
26 Capability
Get tag
Look up the details of a specific tag. This provides context on how a certain label is being used.

Set up in minutes

One URL. Then ask Paperless-ngx to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Paperless-ngx from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_ATPPyZ9x84oVznA3DvTkjjQfOt5pNtonNux3XF3j/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Paperless-ngx, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Paperless-ngx for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_ATPPyZ9x84oVznA3DvTkjjQfOt5pNtonNux3XF3j/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Paperless-ngx URL.
Step 03

Save and start

Save the connection and enable Paperless-ngx in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "paperless-ngx": {
      "url": "https://edge.vinkius.com/vk_preview_ATPPyZ9x84oVznA3DvTkjjQfOt5pNtonNux3XF3j/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Paperless-ngx

Open Agent mode in chat and ask: "Using Paperless-ngx, help me...". 26 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "paperless-ngx": {
      "url": "https://edge.vinkius.com/vk_preview_ATPPyZ9x84oVznA3DvTkjjQfOt5pNtonNux3XF3j/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Paperless-ngx

Ask Copilot: "Using Paperless-ngx, help me...". 26 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "paperless-ngx": {
      "url": "https://edge.vinkius.com/vk_preview_ATPPyZ9x84oVznA3DvTkjjQfOt5pNtonNux3XF3j/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Paperless-ngx

Open Cascade and ask: "Using Paperless-ngx, help me...". 26 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "paperless-ngx": {
      "url": "https://edge.vinkius.com/vk_preview_ATPPyZ9x84oVznA3DvTkjjQfOt5pNtonNux3XF3j/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Paperless-ngx

Ask Cline: "Using Paperless-ngx, help me...". 26 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add paperless-ngx --transport http "https://edge.vinkius.com/vk_preview_ATPPyZ9x84oVznA3DvTkjjQfOt5pNtonNux3XF3j/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Paperless-ngx

Ask Claude: "Using Paperless-ngx, show me...". 26 tools are ready

Where the request belongs

Work Paperless-ngx can move forward.

Built around the request

This is for the person who is drowning in digital paperwork. It's for the professional who needs to find a specific clause in a 50-page PDF or the homeowner who wants to find a warranty without opening twenty different folders.

01

Home Office User

Finds utility bills, tax records, or appliance manuals in seconds by asking your agent.

02

Legal & Admin Clerk

Queries specific correspondents or document types to build reports or verify contract details.

03

Academic Researcher

Manages large collections of papers and PDFs with automated tagging and content retrieval.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

AlgoDocs

AI document extraction orchestration. parse PDFs, images, and Word docs via AI.

02 9 capabilities

Fluxiom

Manage digital assets, organize with tags, and oversee collections via AI agents with Fluxiom DAM.

03 10 capabilities

Parseur

Automate document processing via Parseur. list mailboxes, upload PDFs/Emails, extract structured data pipelines, and trigger template logic natively.

04 12 capabilities

Dropbox Paper

Manage collaborative docs via Dropbox Paper. create documents, search content, handle shared links, and move files directly from any AI agent.

05 10 capabilities

Digify

Equip your AI agent to manage secure files, track data rooms, and monitor document analytics via the Digify API.

06 10 capabilities

Shimo Docs

Collaborative office suite and document management platform. manage Word, Excel, and PPT via AI.

Bring your own AI

Change the model, client or framework. Keep Paperless-ngx connected.

Before you connect

Questions about Paperless-ngx.

The practical details behind the request, access and result.

Does Paperless-ngx MCP work with my existing archive?

Yes, it connects directly to your current Paperless-ngx instance using your API URL and Personal API Token.

Can I use it to search my scanned receipts?

Yes, it uses the OCR text from your scans to find information, so you can ask about specific amounts or dates.

Does it let me download the files?

Yes, your agent can fetch the original document from your archive and provide a download link for you.

How does it handle my private data?

It uses your own private API credentials to communicate with your server, ensuring your data stays within your control.

Can I organize my files using just voice or chat?

Yes, you can tell your agent to create new tags, update contact details, or re-classify documents as you talk to it.

Is there a limit to how many documents it can see?

It can access everything that is hosted on your Paperless-ngx instance, making it a complete solution for your archive.

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

Yes. The list_documents capability 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 capabilities 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.

One connection away

Give your agent a direct line to Paperless-ngx.

Connect Paperless-ngx once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available