Skip to main content
Glama
Sign In
paperless-mcp

paperless-mcp

by gardenbaum
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

paperless-mcp

An MCP server for paperless-ngx 3.x, built on FastMCP 4.

Status: early development. There are no tools yet; the plan lives in backlog/ (Backlog.md).

Configuration

Variable

Meaning

PAPERLESS_URL

Base URL of the Paperless instance (required)

PAPERLESS_TOKEN

Paperless API token (required)

PAPERLESS_PUBLIC_URL

Base URL for links shown to users, if it differs from PAPERLESS_URL

PAPERLESS_MCP_LOG_LEVEL

DEBUG, INFO (default), WARNING, ERROR or CRITICAL

Related MCP server: Paperless MCP

Development

Requires uv, just and Go (pre-commit builds the pinned gitleaks that just check runs over the whole history).

just install                  # create the environment
uv run pre-commit install     # run the gates on every commit
just check                    # the full local gate, identical to CI
just --list                   # all recipes

Lint suppressions name a specific code and a reason, e.g. # noqa: S101 -- reason (see just hygiene). Inline # pragma comments are banned: coverage exclusions are reviewed exclude_also patterns in pyproject.toml.

Licence

MIT, see LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • paperless-mcp

      baruchiro
      A
      license
      B
      quality
      B
      maintenance
      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.
      44
      767 npm
      149
      TypeScript
      ISC

    • Paperless MCP

      pvliesdonk
      A
      license
      C
      quality
      B
      maintenance
      Enables searching, tagging, uploading, and reading documents in Paperless-NGX, with management of tags, correspondents, document types, and custom fields via MCP tools and resources.
      50
      57 PyPI
      1
      MIT