repowisepvliesdonk/paperless-mcp

Code health of pvliesdonk/paperless-mcp

Repowise scores pvliesdonk/paperless-mcp at 8.3 out of 10 for code health, which reads as good, alongside maintainability 8.5 and static performance 9.4 on the same scale. There are 200 open findings across the three pillars, and the lowest-scoring file is server.py at 4.9. Scores are computed from complexity, duplication, churn and git fix history, not from a linter.

Findings by severity

5 critical, 20 high, 91 medium, 50 low.

Hotspots

8 files are flagged as hotspots. The top 5:

  • scripts/gen_config_surface.py: 4 commits in the last 90 days from 1 contributor
  • src/paperless_mcp/server.py: 10 commits in the last 90 days from 1 contributor with 1 recent bug fix
  • src/paperless_mcp/tools/documents.py: 6 commits in the last 90 days from 1 contributor with 2 recent bug fixes
  • src/paperless_mcp/domain.py: 5 commits in the last 90 days from 1 contributor
  • docs/javascripts/config-wizard/generators.js: 3 commits in the last 90 days from 1 contributor

Lowest-scoring files

  • src/paperless_mcp/server.py: 4.9 out of 10
  • src/paperless_mcp/client/tasks.py: 5.1 out of 10 with 3 bug fixes in the last 180 days
  • tests/unit/tools/test_documents.py: 5.4 out of 10 with 2 bug fixes in the last 180 days
  • src/paperless_mcp/client/_http.py: 5.4 out of 10
  • tests/unit/client/test_tasks.py: 5.6 out of 10 with 3 bug fixes in the last 180 days

Checked against bug fixes

Of the 20 files Repowise scores lowest, 10 had a bug fix in the last 180 days. Across all 161 scored files, 14.3% had a bug fix in that window.

Dead code and refactoring

Repowise found 2 unused exports. 12 refactoring targets across 12 files would raise the score.

More on paperless-mcp: summary and FAQ, codebase overview, architecture.

Related guide: Best dead code detection tools by language