Skip to main content

mcp-papra

An MCP server that lets Claude search, read and tag the documents in your Papra instance — read-only by default.

Install

pip install mcp-papra      # or run it without installing: uvx mcp-papra

Create an API key in Papra (read permissions are enough), then set:

Variable Meaning
PAPRA_API_KEY API key (required unless demo mode)
PAPRA_URL Papra API URL (default https://api.papra.app; use your own for self-hosted)
PAPRA_ORGANIZATION_ID Organization id (optional if the key only sees one)
PAPRA_ALLOW_WRITE=1 Also expose upload_document and tag_document
PAPRA_DEMO=1 Fictional documents, no key and no network

Use with Claude Code

claude mcp add papra --env PAPRA_API_KEY=your_key -- uvx mcp-papra
# try it without any account:
claude mcp add papra-demo --env PAPRA_DEMO=1 -- uvx mcp-papra

Use with Claude Desktop

In claude_desktop_config.json:

{
  "mcpServers": {
    "papra": {
      "command": "uvx",
      "args": ["mcp-papra"],
      "env": { "PAPRA_API_KEY": "your_key" }
    }
  }
}

Tools

Tool Mode What it does
search_documents(query, limit) read Search with Papra's advanced syntax (tag:contract AND created:>2024, -has:tags, …); returns metadata, not text
get_document(document_id, max_chars) read Metadata and extracted text, truncated to max_chars
summarize_by_tag(tag, limit) read Name and excerpt of each document with a tag (Papra has tags, not folders); Claude writes the summary
upload_document(path, ocr_languages) write Upload a local file
tag_document(document_id, tag_name) write Attach a tag, creating it if needed

Write tools exist only when PAPRA_ALLOW_WRITE=1. This is an unofficial project, not affiliated with Papra.

Development

pip install -e ".[test]" && pytest   # no network needed

MIT licensed.

Metadata

Release files for mcp-papra 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-papra 0.1.1
File Size Uploaded Provenance Actions
mcp_papra-0.1.1.tar.gz 10.8 kB Without provenance Details for mcp_papra-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-papra 0.1.1
File Interpreter ABI Platform Actions
mcp_papra-0.1.1-py3-none-any.whl Python 3 none any Details for mcp_papra-0.1.1-py3-none-any.whl

Total release size: 20.1 kB

Release files / mcp_papra-0.1.1.tar.gz

Download URL mcp_papra-0.1.1.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
aa53cc6a7000a503931a902ed3a47b24a07dec64f0c408931127fc0c35bc721c
BLAKE2b-256 checksum
How to use checksums
cb51d26c0ab2a6573409af9b72de27fb9946dd05d000d6d6fc7ce2965f46ec64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / mcp_papra-0.1.1-py3-none-any.whl

Download URL mcp_papra-0.1.1-py3-none-any.whl
Size 9.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b9fe861cf182af3ccb5ef0fef2c48597cafd08b5d52ee459491e762bcfa00283
BLAKE2b-256 checksum
How to use checksums
6e1030e1cde579b0a2b46145159c6860db016be97b35c2d092e34239edda2fb0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Security for mcp-papra 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page