Schema | Paperless-ngx MCP Server

Paperless-ngx MCP Server

Describes the environment variables required to run the server.

Name	Required	Description
`PAPERLESS_URL`	Yes	Base URL of the Paperless-ngx instance
`PAPERLESS_TOKEN`	Yes	Paperless API authentication token
`PAPERLESS_DOWNLOAD_DIR`	No	Path where downloaded documents will be saved

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Features and capabilities supported by this server

Protocol revision2025-11-25

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Functions exposed to the LLM to take actions

Name	Description
search_documentsA	Search documents in Paperless. query Full-text search query across content and title tags List of tag names (document must have all specified tags) correspondent Correspondent name document_type Document type name created_after Date YYYY-MM-DD, strictly after created_before Date YYYY-MM-DD, strictly before limit Maximum number of records to return
get_documentC	Retrieve document metadata and extracted OCR text by ID.
download_documentB	Download document file to local disk. original True for original uploaded file, False for archived PDF version save_as Full target path; defaults to PAPERLESS_DOWNLOAD_DIR
list_tagsA	List all tags with document counts.
list_correspondentsA	List all correspondents with document counts.
list_document_typesA	List all document types with document counts.
statsA	Archive summary: counts of documents, tags, correspondents, types, and storage paths.
update_documentA	Update document title, correspondent, type, and tags. correspondent / document_type — name or ID; empty string "" clears the field. add_tags / remove_tags — lists of tag names. create_missing — whether to create missing tags/correspondents/types automatically.
upload_documentA	Upload a file to Paperless. file_path Local path to PDF/image on this machine created Document date YYYY-MM-DD Returns task ID — processing and OCR run asynchronously in the background.

Interactive templates invoked by user choice

Name	Description
No prompts

Contextual data attached and managed by the client

Name	Description
No resources

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NamerekWASD/mcp-paperless'

If you have feedback or need assistance with the MCP directory API, please join our Discord server