Paperless MCP
by pvliesdonk
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FASTMCP_LOG_LEVEL | No | Log level for FastMCP internals and app loggers. | INFO |
| PAPERLESS_MCP_HOST | No | Bind host for HTTP/SSE transport. | 127.0.0.1 |
| PAPERLESS_MCP_PORT | No | Bind port for HTTP/SSE transport. | 8000 |
| PAPERLESS_MCP_OIDC_* | No | OIDC provider settings when OIDC auth is enabled. | |
| PAPERLESS_MCP_BASE_URL | No | Public base URL for artifact download links. | |
| PAPERLESS_MCP_API_TOKEN | Yes | Paperless service-account token. | |
| PAPERLESS_MCP_HTTP_PATH | No | URL path prefix for HTTP transport. | /mcp |
| PAPERLESS_MCP_LOG_LEVEL | No | Log level: DEBUG, INFO, WARNING, ERROR. | INFO |
| PAPERLESS_MCP_READ_ONLY | No | When true, disables every writable tool. | false |
| PAPERLESS_MCP_TRANSPORT | No | Server transport: stdio, http, or sse. | stdio |
| PAPERLESS_MCP_LOG_FORMAT | No | Log format: rich or json. | rich |
| PAPERLESS_MCP_BEARER_TOKEN | No | Static bearer token for simple token auth. | |
| PAPERLESS_MCP_HTTP_RETRIES | No | Retries on 5xx/network errors. | 2 |
| PAPERLESS_MCP_INSTRUCTIONS | No | Operator-supplied description appended to MCP instructions. | built-in |
| FASTMCP_ENABLE_RICH_LOGGING | No | Set to false for plain/structured JSON log output. | true |
| PAPERLESS_MCP_PAPERLESS_URL | Yes | Base URL of the Paperless-NGX REST API (no trailing slash). | |
| PAPERLESS_MCP_EVENT_STORE_URL | No | Event store backend for HTTP session persistence. | memory:// |
| PAPERLESS_MCP_DEFAULT_PAGE_SIZE | No | Default page_size for list tools. Clamped [1, 100]. | 25 |
| PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS | No | Per-request HTTP timeout (seconds). | 30 |
| PAPERLESS_MCP_PAPERLESS_PUBLIC_URL | No | Public-facing Paperless UI URL used to construct user-visible links. Defaults to PAPERLESS_MCP_PAPERLESS_URL when unset. | same as PAPERLESS_MCP_PAPERLESS_URL |
| PAPERLESS_MCP_DOWNLOAD_LINK_TTL_SECONDS | No | TTL of URLs issued by create_download_link. Clamped [30, 3600]. | 300 |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/pvliesdonk/paperless-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server