MCP.so
登录

Paperless-NGX MCP Server

@nloui

基本信息

分类

其他

传输方式

stdio

作者

nloui

关于 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.

Paperless-NGX MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Paperless-NGX MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

1

What are the prerequisites?

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

2

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.

3

What transport modes are supported?

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

4

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.

5

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`.

评论

其他 分类下的更多 MCP 服务器