Paperless-NGX MCP Server

Name: Paperless-NGX MCP Server
Author: nloui

@nloui

About Paperless-NGX MCP Server

An MCP (Model Context Protocol) server for interacting with a Paperless-NGX API server. This server provides tools for managing documents, tags, correspondents, and document types in your Paperless-NGX instance.

#mcp #document-management #paperless-ngx

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "paperless-mcp-nloui": {
      "command": "node",
      "args": [
        "server.js",
        "http://localhost:8000",
        "your-test-token"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Paperless-NGX MCP Server?

An MCP (Model Context Protocol) server for interacting with a Paperless-NGX API server. It provides tools for managing documents, tags, correspondents, and document types in your Paperless-NGX instance.

How to use Paperless-NGX MCP Server?

Install globally via npm install -g paperless-mcp, then add it to your Claude MCP configuration (VSCode extension or desktop app) with the command npx paperless-mcp <baseUrl> <token>. Obtain an API token from your Paperless-NGX profile page.

Key features of Paperless-NGX MCP Server

List, get, search, download, and upload documents
Bulk edit documents (set correspondent, type, tags, merge, split, etc.)
Create and list tags with color and matching rules
Create and list correspondents and document types
Supports both stdio and HTTP (Streamable HTTP Transport) modes

Use cases of Paperless-NGX MCP Server

Search for documents by full-text query or tag
Automate document tagging and correspondent assignment
Upload new documents with metadata (title, date, tags)
Perform bulk operations like merging or splitting documents
Integrate Paperless-NGX document management into AI workflows

FAQ from Paperless-NGX MCP Server

What are the prerequisites?

A running Paperless-NGX instance and a valid API token from that instance.

How do I get an API token?

Log into Paperless-NGX, click your username in the top right, select "My Profile", and click the circular arrow button to generate a new token.

What transport modes are supported?

Two modes: stdio (default) and HTTP (Streamable HTTP Transport) using the --http flag, optionally with --port (default 3000).

What happens if the Paperless-NGX server is unreachable?

The server will show clear error messages indicating the URL or token is incorrect, the server is unreachable, or the operation failed.

Can I run it as an HTTP service?

Yes, run with npm run start -- <baseUrl> <token> --http --port 3000. The MCP API is available at POST /mcp.

Comments

More Other MCP servers

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K