Paperless-NGX MCP Server

Source

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.

Catalog onlyCatalog onlySTDIO

Overview

Paperless-NGX MCP Server is an interface designed to interact with a Paperless-NGX API server, providing tools to manage documents, tags, correspondents, and document types.

To use the MCP Server, first install it via npm. Then, configure your MCP settings to connect to your Paperless-NGX instance and utilize the functionalities provided by the server to manage your documents.

Management of documents, tags, correspondents, and document types - Full-text search capabilities - Bulk operations for efficient document management

Searching for documents by tags or content.
Uploading new documents into the Paperless-NGX system.
Managing and organizing document metadata efficiently.

Add to your AI client

Use these steps to connect Paperless-NGX MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "paperless-mcp-nloui": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-paperless-mcp-nloui"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "paperless-mcp-nloui": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-paperless-mcp-nloui"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "paperless-mcp-nloui": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-paperless-mcp-nloui"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "paperless-mcp-nloui": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-paperless-mcp-nloui"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "paperless-mcp-nloui": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-paperless-mcp-nloui"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "paperless-mcp-nloui": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-paperless-mcp-nloui"
      ]
    }
  }
}

FAQ

How do I install the MCP server?

Use the npm command: `npm install -g paperless-mcp`.

Can I perform bulk operations on documents?

Yes, the MCP server supports bulk editing for various document operations.

Is there an official API documentation available?

Yes, you can refer to the [official documentation](https://docs.paperless-ngx.com/api/) for detailed information.

Developer tools