Feature: mcp server

Auto translate strings
Enhancement: improve relative dates in date filter (#11899 )
2026-01-28 22:59:03 -06:00 · 2026-01-27 00:20:45 -08:00 · 2026-01-26 20:58:22 +00:00 · 2026-01-26 12:56:29 -08:00 · 2026-01-26 20:12:45 +00:00 · 2026-01-26 12:10:57 -08:00
37 changed files with 1658 additions and 486 deletions
--- a/.github/workflows/ci-docs.yml
+++ b/.github/workflows/ci-docs.yml
@@ -23,7 +23,7 @@ env:
 jobs:
  build:
    name: Build Documentation
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - name: Checkout
        uses: actions/checkout@v6
@@ -58,7 +58,7 @@ jobs:
    name: Deploy Documentation
    needs: build
    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - name: Checkout
        uses: actions/checkout@v6
--- a/.github/workflows/ci-lint.yml
+++ b/.github/workflows/ci-lint.yml
@@ -12,7 +12,7 @@ concurrency:
 jobs:
  pre-commit:
    name: Pre-commit Checks
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - name: Checkout
        uses: actions/checkout@v6
--- a/.github/workflows/crowdin.yml
+++ b/.github/workflows/crowdin.yml
@@ -10,7 +10,7 @@ jobs:
  synchronize-with-crowdin:
    name: Crowdin Sync
    if: github.repository_owner == 'paperless-ngx'
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - name: Checkout
        uses: actions/checkout@v6
--- a/.github/workflows/pr-bot.yml
+++ b/.github/workflows/pr-bot.yml
@@ -8,7 +8,7 @@ permissions:
 jobs:
  pr-bot:
    name: Automated PR Bot
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-latest
    steps:
      - name: Label PR by file path or branch name
        # see .github/labeler.yml for the labeler config
--- a/.github/workflows/project-actions.yml
+++ b/.github/workflows/project-actions.yml
@@ -12,7 +12,7 @@ permissions:
 jobs:
  pr_opened_or_reopened:
    name: pr_opened_or_reopened
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    permissions:
      # write permission is required for autolabeler
      pull-requests: write
--- a/.github/workflows/repo-maintenance.yml
+++ b/.github/workflows/repo-maintenance.yml
@@ -13,7 +13,7 @@ jobs:
  stale:
    name: 'Stale'
    if: github.repository_owner == 'paperless-ngx'
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - uses: actions/stale@v10
        with:
@@ -35,7 +35,7 @@ jobs:
  lock-threads:
    name: 'Lock Old Threads'
    if: github.repository_owner == 'paperless-ngx'
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - uses: dessant/lock-threads@v6
        with:
@@ -55,7 +55,7 @@ jobs:
  close-answered-discussions:
    name: 'Close Answered Discussions'
    if: github.repository_owner == 'paperless-ngx'
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - uses: actions/github-script@v8
        with:
@@ -112,7 +112,7 @@ jobs:
  close-outdated-discussions:
    name: 'Close Outdated Discussions'
    if: github.repository_owner == 'paperless-ngx'
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - uses: actions/github-script@v8
        with:
@@ -204,7 +204,7 @@ jobs:
  close-unsupported-feature-requests:
    name: 'Close Unsupported Feature Requests'
    if: github.repository_owner == 'paperless-ngx'
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-24.04
    steps:
      - uses: actions/github-script@v8
        with:
--- a/.github/workflows/translate-strings.yml
+++ b/.github/workflows/translate-strings.yml
@@ -6,7 +6,7 @@ on:
 jobs:
  generate-translate-strings:
    name: Generate Translation Strings
-    runs-on: ubuntu-slim
+    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
--- a/docs/api.md
+++ b/docs/api.md
@@ -60,6 +60,20 @@ The REST api provides five different forms of authentication.
    [here](advanced_usage.md#openid-connect-and-social-authentication) for more
    information on social accounts.

+## Model Context Protocol (MCP)
+
+Paperless-ngx exposes an MCP endpoint powered by `django-mcp-server` so MCP
+clients can query data collections, run full-text document search, and invoke
+DRF-backed CRUD tools.
+
+-   Endpoint: `/mcp/`
+-   Authentication: identical to the REST API (Basic, Session, Token, or Remote
+    User depending on your configuration).
+
+The MCP server uses existing DRF viewsets and permissions. It also exposes a
+`query_data_collections` tool for structured querying across published models
+and a `search_documents` tool for full-text search.
+
 ## Searching for documents

 Full text searching is available on the `/api/documents/` endpoint. Two
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -1152,8 +1152,9 @@ via the consumption directory, you can disable the consumer to save resources.

 #### [`PAPERLESS_CONSUMER_DELETE_DUPLICATES=<bool>`](#PAPERLESS_CONSUMER_DELETE_DUPLICATES) {#PAPERLESS_CONSUMER_DELETE_DUPLICATES}

-: When the consumer detects a duplicate document, it will not touch
-the original document. This default behavior can be changed here.
+: As of version 3.0 Paperless-ngx allows duplicate documents to be consumed by default, _except_ when
+this setting is enabled. When enabled, Paperless will check if a document with the same hash already
+exists in the system and delete the duplicate file from the consumption directory without consuming it.

    Defaults to false.

--- a/pyproject.toml
+++ b/pyproject.toml
@@ -36,6 +36,7 @@ dependencies = [
  "django-extensions~=4.1",
  "django-filter~=25.1",
  "django-guardian~=3.2.0",
+  "django-mcp-server~=0.5.7",
  "django-multiselectfield~=1.0.1",
  "django-soft-delete~=1.0.18",
  "django-treenode>=0.23.2",
--- a/src-ui/messages.xlf
+++ b/src-ui/messages.xlf
@@ -534,7 +534,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">396</context>
+          <context context-type="linenumber">427</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3768927257183755959" datatype="html">
@@ -593,7 +593,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">389</context>
+          <context context-type="linenumber">420</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/custom-fields-bulk-edit-dialog/custom-fields-bulk-edit-dialog.component.html</context>
@@ -761,7 +761,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">409</context>
+          <context context-type="linenumber">440</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/document-list.component.html</context>
@@ -1867,11 +1867,18 @@
          <context context-type="linenumber">97</context>
        </context-group>
      </trans-unit>
+      <trans-unit id="1418249006616536391" datatype="html">
+        <source>Duplicate(s) detected</source>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
+          <context context-type="linenumber">103</context>
+        </context-group>
+      </trans-unit>
      <trans-unit id="1536087519743707362" datatype="html">
        <source>Dismiss</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">110</context>
+          <context context-type="linenumber">116</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.ts</context>
@@ -1882,49 +1889,49 @@
        <source>Open Document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">115</context>
+          <context context-type="linenumber">121</context>
        </context-group>
      </trans-unit>
      <trans-unit id="428536141871853903" datatype="html">
        <source>{VAR_PLURAL, plural, =1 {One <x id="INTERPOLATION"/> task} other {<x id="INTERPOLATION_1"/> total <x id="INTERPOLATION"/> tasks}}</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">134</context>
+          <context context-type="linenumber">140</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1943508481059904274" datatype="html">
        <source> (<x id="INTERPOLATION" equiv-text="{{selectedTasks.size}}"/> selected)</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">136</context>
+          <context context-type="linenumber">142</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5639839509673911668" datatype="html">
        <source>Failed<x id="START_BLOCK_IF" equiv-text="@if (tasksService.failedFileTasks.length &gt; 0) {"/><x id="START_TAG_SPAN" ctype="x-span" equiv-text="&lt;span class=&quot;badge bg-danger ms-2&quot;&gt;"/><x id="INTERPOLATION" equiv-text="{{tasksService.failedFileTasks.length}}"/><x id="CLOSE_TAG_SPAN" ctype="x-span" equiv-text="&lt;/span&gt;"/><x id="CLOSE_BLOCK_IF" equiv-text="}"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">148,150</context>
+          <context context-type="linenumber">154,156</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8210778930307085868" datatype="html">
        <source>Complete<x id="START_BLOCK_IF" equiv-text="@if (tasksService.completedFileTasks.length &gt; 0) {"/><x id="START_TAG_SPAN" ctype="x-span" equiv-text="&lt;span class=&quot;badge bg-secondary ms-2&quot;&gt;"/><x id="INTERPOLATION" equiv-text="{{tasksService.completedFileTasks.length}}"/><x id="CLOSE_TAG_SPAN" ctype="x-span" equiv-text="&lt;/span&gt;"/><x id="CLOSE_BLOCK_IF" equiv-text="}"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">156,158</context>
+          <context context-type="linenumber">162,164</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3522801015717851360" datatype="html">
        <source>Started<x id="START_BLOCK_IF" equiv-text="@if (tasksService.startedFileTasks.length &gt; 0) {"/><x id="START_TAG_SPAN" ctype="x-span" equiv-text="&lt;span class=&quot;badge bg-secondary ms-2&quot;&gt;"/><x id="INTERPOLATION" equiv-text="{{tasksService.startedFileTasks.length}}"/><x id="CLOSE_TAG_SPAN" ctype="x-span" equiv-text="&lt;/span&gt;"/><x id="CLOSE_BLOCK_IF" equiv-text="}"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">164,166</context>
+          <context context-type="linenumber">170,172</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2341807459308874922" datatype="html">
        <source>Queued<x id="START_BLOCK_IF" equiv-text="@if (tasksService.queuedFileTasks.length &gt; 0) {"/><x id="START_TAG_SPAN" ctype="x-span" equiv-text="&lt;span class=&quot;badge bg-secondary ms-2&quot;&gt;"/><x id="INTERPOLATION" equiv-text="{{tasksService.queuedFileTasks.length}}"/><x id="CLOSE_TAG_SPAN" ctype="x-span" equiv-text="&lt;/span&gt;"/><x id="CLOSE_BLOCK_IF" equiv-text="}"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/admin/tasks/tasks.component.html</context>
-          <context context-type="linenumber">172,174</context>
+          <context context-type="linenumber">178,180</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2525230676386818985" datatype="html">
@@ -2591,11 +2598,11 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1098</context>
+          <context context-type="linenumber">1112</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1463</context>
+          <context context-type="linenumber">1477</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -3221,7 +3228,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1051</context>
+          <context context-type="linenumber">1065</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -3326,7 +3333,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1514</context>
+          <context context-type="linenumber">1528</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6661109599266152398" datatype="html">
@@ -3337,7 +3344,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1515</context>
+          <context context-type="linenumber">1529</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5162686434580248853" datatype="html">
@@ -3348,7 +3355,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1516</context>
+          <context context-type="linenumber">1530</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8157388568390631653" datatype="html">
@@ -3437,7 +3444,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/dates-dropdown/dates-dropdown.component.ts</context>
-          <context context-type="linenumber">111</context>
+          <context context-type="linenumber">113</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/input/date/date.component.html</context>
@@ -3697,14 +3704,14 @@
        <source>This month</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/dates-dropdown/dates-dropdown.component.ts</context>
-          <context context-type="linenumber">106</context>
+          <context context-type="linenumber">107</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4498682414491138092" datatype="html">
        <source>Yesterday</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/dates-dropdown/dates-dropdown.component.ts</context>
-          <context context-type="linenumber">116</context>
+          <context context-type="linenumber">118</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/pipes/custom-date.pipe.ts</context>
@@ -3715,28 +3722,28 @@
        <source>Previous week</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/dates-dropdown/dates-dropdown.component.ts</context>
-          <context context-type="linenumber">121</context>
+          <context context-type="linenumber">123</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8586908745456864217" datatype="html">
        <source>Previous month</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/dates-dropdown/dates-dropdown.component.ts</context>
-          <context context-type="linenumber">135</context>
+          <context context-type="linenumber">137</context>
        </context-group>
      </trans-unit>
      <trans-unit id="357608474534295480" datatype="html">
        <source>Previous quarter</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/dates-dropdown/dates-dropdown.component.ts</context>
-          <context context-type="linenumber">141</context>
+          <context context-type="linenumber">143</context>
        </context-group>
      </trans-unit>
      <trans-unit id="100513227838842152" datatype="html">
        <source>Previous year</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/common/dates-dropdown/dates-dropdown.component.ts</context>
-          <context context-type="linenumber">155</context>
+          <context context-type="linenumber">157</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8743659855412792665" datatype="html">
@@ -6984,7 +6991,7 @@
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1462</context>
+          <context context-type="linenumber">1476</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2336375155355449543" datatype="html">
@@ -7249,88 +7256,109 @@
          <context context-type="linenumber">354</context>
        </context-group>
      </trans-unit>
+      <trans-unit id="8236092845697214347" datatype="html">
+        <source> Duplicates <x id="START_TAG_SPAN" ctype="x-span" equiv-text="&lt;span class=&quot;badge text-bg-secondary ms-1&quot;&gt;"/><x id="INTERPOLATION" equiv-text="te_documents.length }}"/><x id="CLOSE_TAG_SPAN" ctype="x-span"/></source>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
+          <context context-type="linenumber">376,380</context>
+        </context-group>
+      </trans-unit>
+      <trans-unit id="6449374629822973702" datatype="html">
+        <source>Duplicate documents detected:</source>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
+          <context context-type="linenumber">382</context>
+        </context-group>
+      </trans-unit>
+      <trans-unit id="14058600336670816" datatype="html">
+        <source>In trash</source>
+        <context-group purpose="location">
+          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
+          <context context-type="linenumber">393</context>
+        </context-group>
+      </trans-unit>
      <trans-unit id="5129524307369213584" datatype="html">
        <source>Save &amp; next</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">391</context>
+          <context context-type="linenumber">422</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4910102545766233758" datatype="html">
        <source>Save &amp; close</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">394</context>
+          <context context-type="linenumber">425</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1309556917227148591" datatype="html">
        <source>Document loading...</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">404</context>
+          <context context-type="linenumber">435</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8191371354890763172" datatype="html">
        <source>Enter Password</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.html</context>
-          <context context-type="linenumber">458</context>
+          <context context-type="linenumber">489</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2218903673684131427" datatype="html">
        <source>An error occurred loading content: <x id="PH" equiv-text="err.message ?? err.toString()"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">430,432</context>
+          <context context-type="linenumber">432,434</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3200733026060976258" datatype="html">
        <source>Document changes detected</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">464</context>
+          <context context-type="linenumber">471</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2887155916749964" datatype="html">
        <source>The version of this document in your browser session appears older than the existing version.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">465</context>
+          <context context-type="linenumber">472</context>
        </context-group>
      </trans-unit>
      <trans-unit id="237142428785956348" datatype="html">
        <source>Saving the document here may overwrite other changes that were made. To restore the existing version, discard your changes or close the document.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">466</context>
+          <context context-type="linenumber">473</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8720977247725652816" datatype="html">
        <source>Ok</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">468</context>
+          <context context-type="linenumber">475</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6142395741265832184" datatype="html">
        <source>Next document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">594</context>
+          <context context-type="linenumber">601</context>
        </context-group>
      </trans-unit>
      <trans-unit id="651985345816518480" datatype="html">
        <source>Previous document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">604</context>
+          <context context-type="linenumber">611</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2885986061416655600" datatype="html">
        <source>Close document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">612</context>
+          <context context-type="linenumber">619</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/services/open-documents.service.ts</context>
@@ -7341,67 +7369,67 @@
        <source>Save document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">619</context>
+          <context context-type="linenumber">626</context>
        </context-group>
      </trans-unit>
      <trans-unit id="1784543155727940353" datatype="html">
        <source>Save and close / next</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">628</context>
+          <context context-type="linenumber">635</context>
        </context-group>
      </trans-unit>
      <trans-unit id="5758784066858623886" datatype="html">
        <source>Error retrieving metadata</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">683</context>
+          <context context-type="linenumber">690</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3456881259945295697" datatype="html">
        <source>Error retrieving suggestions.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">731</context>
+          <context context-type="linenumber">745</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2194092841814123758" datatype="html">
        <source>Document &quot;<x id="PH" equiv-text="newValues.title"/>&quot; saved successfully.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">940</context>
+          <context context-type="linenumber">954</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">964</context>
+          <context context-type="linenumber">978</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6626387786259219838" datatype="html">
        <source>Error saving document &quot;<x id="PH" equiv-text="this.document.title"/>&quot;</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">970</context>
+          <context context-type="linenumber">984</context>
        </context-group>
      </trans-unit>
      <trans-unit id="448882439049417053" datatype="html">
        <source>Error saving document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1020</context>
+          <context context-type="linenumber">1034</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8410796510716511826" datatype="html">
        <source>Do you really want to move the document &quot;<x id="PH" equiv-text="this.document.title"/>&quot; to the trash?</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1052</context>
+          <context context-type="linenumber">1066</context>
        </context-group>
      </trans-unit>
      <trans-unit id="282586936710748252" datatype="html">
        <source>Documents can be restored prior to permanent deletion.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1053</context>
+          <context context-type="linenumber">1067</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -7412,7 +7440,7 @@
        <source>Move to trash</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1055</context>
+          <context context-type="linenumber">1069</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -7423,14 +7451,14 @@
        <source>Error deleting document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1074</context>
+          <context context-type="linenumber">1088</context>
        </context-group>
      </trans-unit>
      <trans-unit id="619486176823357521" datatype="html">
        <source>Reprocess confirm</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1094</context>
+          <context context-type="linenumber">1108</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-list/bulk-editor/bulk-editor.component.ts</context>
@@ -7441,102 +7469,102 @@
        <source>This operation will permanently recreate the archive file for this document.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1095</context>
+          <context context-type="linenumber">1109</context>
        </context-group>
      </trans-unit>
      <trans-unit id="302054111564709516" datatype="html">
        <source>The archive file will be re-generated with the current settings.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1096</context>
+          <context context-type="linenumber">1110</context>
        </context-group>
      </trans-unit>
      <trans-unit id="8251197608401006898" datatype="html">
        <source>Reprocess operation for &quot;<x id="PH" equiv-text="this.document.title"/>&quot; will begin in the background. Close and re-open or reload this document after the operation has completed to see new content.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1106</context>
+          <context context-type="linenumber">1120</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4409560272830824468" datatype="html">
        <source>Error executing operation</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1117</context>
+          <context context-type="linenumber">1131</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6030453331794586802" datatype="html">
        <source>Error downloading document</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1166</context>
+          <context context-type="linenumber">1180</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4458954481601077369" datatype="html">
        <source>Page Fit</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1243</context>
+          <context context-type="linenumber">1257</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4663705961777238777" datatype="html">
        <source>PDF edit operation for &quot;<x id="PH" equiv-text="this.document.title"/>&quot; will begin in the background.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1481</context>
+          <context context-type="linenumber">1495</context>
        </context-group>
      </trans-unit>
      <trans-unit id="9043972994040261999" datatype="html">
        <source>Error executing PDF edit operation</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1493</context>
+          <context context-type="linenumber">1507</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6172690334763056188" datatype="html">
        <source>Please enter the current password before attempting to remove it.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1504</context>
+          <context context-type="linenumber">1518</context>
        </context-group>
      </trans-unit>
      <trans-unit id="968660764814228922" datatype="html">
        <source>Password removal operation for &quot;<x id="PH" equiv-text="this.document.title"/>&quot; will begin in the background.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1536</context>
+          <context context-type="linenumber">1550</context>
        </context-group>
      </trans-unit>
      <trans-unit id="2282118435712883014" datatype="html">
        <source>Error executing password removal operation</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1550</context>
+          <context context-type="linenumber">1564</context>
        </context-group>
      </trans-unit>
      <trans-unit id="3740891324955700797" datatype="html">
        <source>Print failed.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1587</context>
+          <context context-type="linenumber">1601</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6457245677384603573" datatype="html">
        <source>Error loading document for printing.</source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1599</context>
+          <context context-type="linenumber">1613</context>
        </context-group>
      </trans-unit>
      <trans-unit id="6085793215710522488" datatype="html">
        <source>An error occurred loading tiff: <x id="PH" equiv-text="err.toString()"/></source>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1664</context>
+          <context context-type="linenumber">1678</context>
        </context-group>
        <context-group purpose="location">
          <context context-type="sourcefile">src/app/components/document-detail/document-detail.component.ts</context>
-          <context context-type="linenumber">1668</context>
+          <context context-type="linenumber">1682</context>
        </context-group>
      </trans-unit>
      <trans-unit id="4958946940233632319" datatype="html">
--- a/src-ui/src/app/components/admin/tasks/tasks.component.html
+++ b/src-ui/src/app/components/admin/tasks/tasks.component.html
@@ -97,6 +97,12 @@
                  <br/><em>(<ng-container i18n>click for full output</ng-container>)</em>
                }
              </ng-template>
+              @if (task.duplicate_documents?.length > 0) {
+                <div class="small text-warning-emphasis d-flex align-items-center gap-1">
+                  <i-bs class="lh-1" width="1em" height="1em" name="exclamation-triangle"></i-bs>
+                  <span i18n>Duplicate(s) detected</span>
+                </div>
+              }
            </td>
          }
          <td class="d-lg-none">
--- a/src-ui/src/app/components/common/dates-dropdown/dates-dropdown.component.html
+++ b/src-ui/src/app/components/common/dates-dropdown/dates-dropdown.component.html
@@ -164,9 +164,11 @@
    {{ item.name }}
    <span class="ms-auto text-muted small">
      @if (item.dateEnd) {
-        {{ item.date | customDate:'MMM d' }} &ndash; {{ item.dateEnd | customDate:'mediumDate' }}
+        {{ item.date | customDate:'mediumDate' }} &ndash; {{ item.dateEnd | customDate:'mediumDate' }}
+      } @else if (item.dateTilNow) {
+        {{ item.dateTilNow | customDate:'mediumDate' }} &ndash; <ng-container i18n>now</ng-container>
      } @else {
-        {{ item.date | customDate:'mediumDate' }} &ndash; <ng-container i18n>now</ng-container>
+        {{ item.date | customDate:'mediumDate' }}
      }
    </span>
  </div>
--- a/src-ui/src/app/components/common/dates-dropdown/dates-dropdown.component.ts
+++ b/src-ui/src/app/components/common/dates-dropdown/dates-dropdown.component.ts
@@ -79,32 +79,34 @@ export class DatesDropdownComponent implements OnInit, OnDestroy {
    {
      id: RelativeDate.WITHIN_1_WEEK,
      name: $localize`Within 1 week`,
-      date: new Date().setDate(new Date().getDate() - 7),
+      dateTilNow: new Date().setDate(new Date().getDate() - 7),
    },
    {
      id: RelativeDate.WITHIN_1_MONTH,
      name: $localize`Within 1 month`,
-      date: new Date().setMonth(new Date().getMonth() - 1),
+      dateTilNow: new Date().setMonth(new Date().getMonth() - 1),
    },
    {
      id: RelativeDate.WITHIN_3_MONTHS,
      name: $localize`Within 3 months`,
-      date: new Date().setMonth(new Date().getMonth() - 3),
+      dateTilNow: new Date().setMonth(new Date().getMonth() - 3),
    },
    {
      id: RelativeDate.WITHIN_1_YEAR,
      name: $localize`Within 1 year`,
-      date: new Date().setFullYear(new Date().getFullYear() - 1),
+      dateTilNow: new Date().setFullYear(new Date().getFullYear() - 1),
    },
    {
      id: RelativeDate.THIS_YEAR,
      name: $localize`This year`,
      date: new Date('1/1/' + new Date().getFullYear()),
+      dateEnd: new Date('12/31/' + new Date().getFullYear()),
    },
    {
      id: RelativeDate.THIS_MONTH,
      name: $localize`This month`,
      date: new Date().setDate(1),
+      dateEnd: new Date(new Date().getFullYear(), new Date().getMonth() + 1, 0),
    },
    {
      id: RelativeDate.TODAY,
--- a/src-ui/src/app/components/document-detail/document-detail.component.html
+++ b/src-ui/src/app/components/document-detail/document-detail.component.html
@@ -370,6 +370,37 @@
            </ng-template>
          </li>
        }
+
+        @if (document?.duplicate_documents?.length) {
+          <li [ngbNavItem]="DocumentDetailNavIDs.Duplicates">
+            <a class="text-nowrap" ngbNavLink i18n>
+              Duplicates
+              <span class="badge text-bg-secondary ms-1">{{ document.duplicate_documents.length }}</span>
+            </a>
+            <ng-template ngbNavContent>
+              <div class="d-flex flex-column gap-2">
+                <div class="fst-italic" i18n>Duplicate documents detected:</div>
+                <div class="list-group">
+                  @for (duplicate of document.duplicate_documents; track duplicate.id) {
+                    <a
+                      class="list-group-item list-group-item-action d-flex justify-content-between align-items-center"
+                      [routerLink]="['/documents', duplicate.id, 'details']"
+                      [class.disabled]="duplicate.deleted_at"
+                    >
+                      <span class="d-flex align-items-center gap-2">
+                        <span>{{ duplicate.title || ('#' + duplicate.id) }}</span>
+                        @if (duplicate.deleted_at) {
+                          <span class="badge text-bg-secondary" i18n>In trash</span>
+                        }
+                      </span>
+                      <span class="text-secondary">#{{ duplicate.id }}</span>
+                    </a>
+                  }
+                </div>
+              </div>
+            </ng-template>
+          </li>
+        }
      </ul>

      <div [ngbNavOutlet]="nav" class="mt-3"></div>
--- a/src-ui/src/app/components/document-detail/document-detail.component.spec.ts
+++ b/src-ui/src/app/components/document-detail/document-detail.component.spec.ts
@@ -301,16 +301,16 @@ describe('DocumentDetailComponent', () => {
      .spyOn(openDocumentsService, 'openDocument')
      .mockReturnValueOnce(of(true))
    fixture.detectChanges()
-    expect(component.activeNavID).toEqual(5) // DocumentDetailNavIDs.Notes
+    expect(component.activeNavID).toEqual(component.DocumentDetailNavIDs.Notes)
  })

  it('should change url on tab switch', () => {
    initNormally()
    const navigateSpy = jest.spyOn(router, 'navigate')
-    component.nav.select(5)
+    component.nav.select(component.DocumentDetailNavIDs.Notes)
    component.nav.navChange.next({
      activeId: 1,
-      nextId: 5,
+      nextId: component.DocumentDetailNavIDs.Notes,
      preventDefault: () => {},
    })
    fixture.detectChanges()
@@ -352,6 +352,18 @@ describe('DocumentDetailComponent', () => {
    expect(component.document).toEqual(doc)
  })

+  it('should fall back to details tab when duplicates tab is active but no duplicates', () => {
+    initNormally()
+    component.activeNavID = component.DocumentDetailNavIDs.Duplicates
+    const noDupDoc = { ...doc, duplicate_documents: [] }
+
+    component.updateComponent(noDupDoc)
+
+    expect(component.activeNavID).toEqual(
+      component.DocumentDetailNavIDs.Details
+    )
+  })
+
  it('should load already-opened document via param', () => {
    initNormally()
    jest.spyOn(documentService, 'get').mockReturnValueOnce(of(doc))
@@ -367,6 +379,38 @@ describe('DocumentDetailComponent', () => {
    expect(component.document).toEqual(doc)
  })

+  it('should update cached open document duplicates when reloading an open doc', () => {
+    const openDoc = { ...doc, duplicate_documents: [{ id: 1, title: 'Old' }] }
+    const updatedDuplicates = [
+      { id: 2, title: 'Newer duplicate', deleted_at: null },
+    ]
+    jest
+      .spyOn(activatedRoute, 'paramMap', 'get')
+      .mockReturnValue(of(convertToParamMap({ id: 3, section: 'details' })))
+    jest.spyOn(documentService, 'get').mockReturnValue(
+      of({
+        ...doc,
+        modified: new Date('2024-01-02T00:00:00Z'),
+        duplicate_documents: updatedDuplicates,
+      })
+    )
+    jest.spyOn(openDocumentsService, 'getOpenDocument').mockReturnValue(openDoc)
+    const saveSpy = jest.spyOn(openDocumentsService, 'save')
+    jest.spyOn(openDocumentsService, 'openDocument').mockReturnValue(of(true))
+    jest.spyOn(customFieldsService, 'listAll').mockReturnValue(
+      of({
+        count: customFields.length,
+        all: customFields.map((f) => f.id),
+        results: customFields,
+      })
+    )
+
+    fixture.detectChanges()
+
+    expect(openDoc.duplicate_documents).toEqual(updatedDuplicates)
+    expect(saveSpy).toHaveBeenCalled()
+  })
+
  it('should disable form if user cannot edit', () => {
    currentUserHasObjectPermissions = false
    initNormally()
--- a/src-ui/src/app/components/document-detail/document-detail.component.ts
+++ b/src-ui/src/app/components/document-detail/document-detail.component.ts
@@ -8,7 +8,7 @@ import {
  FormsModule,
  ReactiveFormsModule,
 } from '@angular/forms'
-import { ActivatedRoute, Router } from '@angular/router'
+import { ActivatedRoute, Router, RouterModule } from '@angular/router'
 import {
  NgbDateStruct,
  NgbDropdownModule,
@@ -124,6 +124,7 @@ enum DocumentDetailNavIDs {
  Notes = 5,
  Permissions = 6,
  History = 7,
+  Duplicates = 8,
 }

 enum ContentRenderType {
@@ -181,6 +182,7 @@ export enum ZoomSetting {
    NgxBootstrapIconsModule,
    PdfViewerModule,
    TextAreaComponent,
+    RouterModule,
  ],
 })
 export class DocumentDetailComponent
@@ -454,6 +456,11 @@ export class DocumentDetailComponent
          const openDocument = this.openDocumentService.getOpenDocument(
            this.documentId
          )
+          // update duplicate documents if present
+          if (openDocument && doc?.duplicate_documents) {
+            openDocument.duplicate_documents = doc.duplicate_documents
+            this.openDocumentService.save()
+          }
          const useDoc = openDocument || doc
          if (openDocument) {
            if (
@@ -704,6 +711,13 @@ export class DocumentDetailComponent
    }
    this.title = this.documentTitlePipe.transform(doc.title)
    this.prepareForm(doc)
+
+    if (
+      this.activeNavID === DocumentDetailNavIDs.Duplicates &&
+      !doc?.duplicate_documents?.length
+    ) {
+      this.activeNavID = DocumentDetailNavIDs.Details
+    }
  }

  get customFieldFormFields(): FormArray {
--- a/src-ui/src/app/data/document.ts
+++ b/src-ui/src/app/data/document.ts
@@ -159,6 +159,8 @@ export interface Document extends ObjectWithPermissions {

  page_count?: number

+  duplicate_documents?: Document[]
+
  // Frontend only
  __changedFields?: string[]
 }
--- a/src-ui/src/app/data/paperless-task.ts
+++ b/src-ui/src/app/data/paperless-task.ts
@@ -1,3 +1,4 @@
+import { Document } from './document'
 import { ObjectWithId } from './object-with-id'

 export enum PaperlessTaskType {
@@ -42,5 +43,7 @@ export interface PaperlessTask extends ObjectWithId {

  related_document?: number

+  duplicate_documents?: Document[]
+
  owner?: number
 }
--- a/src/documents/consumer.py
+++ b/src/documents/consumer.py
@@ -779,19 +779,45 @@ class ConsumerPreflightPlugin(
            Q(checksum=checksum) | Q(archive_checksum=checksum),
        )
        if existing_doc.exists():
-            msg = ConsumerStatusShortMessage.DOCUMENT_ALREADY_EXISTS
-            log_msg = f"Not consuming {self.filename}: It is a duplicate of {existing_doc.get().title} (#{existing_doc.get().pk})."
+            existing_doc = existing_doc.order_by("-created")
+            duplicates_in_trash = existing_doc.filter(deleted_at__isnull=False)
+            log_msg = (
+                f"Consuming duplicate {self.filename}: "
+                f"{existing_doc.count()} existing document(s) share the same content."
+            )

-            if existing_doc.first().deleted_at is not None:
-                msg = ConsumerStatusShortMessage.DOCUMENT_ALREADY_EXISTS_IN_TRASH
-                log_msg += " Note: existing document is in the trash."
+            if duplicates_in_trash.exists():
+                log_msg += " Note: at least one existing document is in the trash."
+
+            self.log.warning(log_msg)

            if settings.CONSUMER_DELETE_DUPLICATES:
+                duplicate = existing_doc.first()
+                duplicate_label = (
+                    duplicate.title
+                    or duplicate.original_filename
+                    or (Path(duplicate.filename).name if duplicate.filename else None)
+                    or str(duplicate.pk)
+                )
+
                Path(self.input_doc.original_file).unlink()
-            self._fail(
-                msg,
-                log_msg,
-            )
+
+                failure_msg = (
+                    f"Not consuming {self.filename}: "
+                    f"It is a duplicate of {duplicate_label} (#{duplicate.pk})"
+                )
+                status_msg = ConsumerStatusShortMessage.DOCUMENT_ALREADY_EXISTS
+
+                if duplicates_in_trash.exists():
+                    status_msg = (
+                        ConsumerStatusShortMessage.DOCUMENT_ALREADY_EXISTS_IN_TRASH
+                    )
+                    failure_msg += " Note: existing document is in the trash."
+
+                self._fail(
+                    status_msg,
+                    failure_msg,
+                )

    def pre_check_directories(self):
        """
--- a/src/documents/mcp.py
+++ b/src/documents/mcp.py
@@ -0,0 +1,481 @@
+from __future__ import annotations
+
+from django.db.models import Q
+from django.http import QueryDict
+from mcp_server import MCPToolset
+from mcp_server import ModelQueryToolset
+from mcp_server import drf_publish_create_mcp_tool
+from mcp_server import drf_publish_destroy_mcp_tool
+from mcp_server import drf_publish_list_mcp_tool
+from mcp_server import drf_publish_update_mcp_tool
+from rest_framework.response import Response
+
+from documents.models import Correspondent
+from documents.models import CustomField
+from documents.models import Document
+from documents.models import DocumentType
+from documents.models import Note
+from documents.models import SavedView
+from documents.models import ShareLink
+from documents.models import StoragePath
+from documents.models import Tag
+from documents.models import Workflow
+from documents.models import WorkflowAction
+from documents.models import WorkflowTrigger
+from documents.permissions import get_objects_for_user_owner_aware
+from documents.views import CorrespondentViewSet
+from documents.views import CustomFieldViewSet
+from documents.views import DocumentTypeViewSet
+from documents.views import SavedViewViewSet
+from documents.views import ShareLinkViewSet
+from documents.views import StoragePathViewSet
+from documents.views import TagViewSet
+from documents.views import TasksViewSet
+from documents.views import UnifiedSearchViewSet
+from documents.views import WorkflowActionViewSet
+from documents.views import WorkflowTriggerViewSet
+from documents.views import WorkflowViewSet
+
+VIEWSET_ACTIONS = {
+    "create": {"post": "create"},
+    "list": {"get": "list"},
+    "update": {"put": "update"},
+    "destroy": {"delete": "destroy"},
+}
+
+BODY_SCHEMA = {"type": "object", "additionalProperties": True}
+
+VIEWSET_INSTRUCTIONS = {
+    CorrespondentViewSet: "Manage correspondents.",
+    TagViewSet: "Manage tags.",
+    UnifiedSearchViewSet: "Search and manage documents.",
+    DocumentTypeViewSet: "Manage document types.",
+    StoragePathViewSet: "Manage storage paths.",
+    SavedViewViewSet: "Manage saved views.",
+    ShareLinkViewSet: "Manage share links.",
+    WorkflowTriggerViewSet: "Manage workflow triggers.",
+    WorkflowActionViewSet: "Manage workflow actions.",
+    WorkflowViewSet: "Manage workflows.",
+    CustomFieldViewSet: "Manage custom fields.",
+    TasksViewSet: "List background tasks.",
+}
+
+
+class OwnerAwareQueryToolsetMixin:
+    permission: str
+
+    def get_queryset(self):
+        user = getattr(self.request, "user", None)
+        if not user or not user.is_authenticated:
+            return self.model.objects.none()
+        if user.is_superuser:
+            return self.model._default_manager.all()
+        return get_objects_for_user_owner_aware(user, self.permission, self.model)
+
+
+class DocumentQueryToolset(ModelQueryToolset):
+    model = Document
+    search_fields = ["title", "content"]
+
+    def get_queryset(self):
+        user = getattr(self.request, "user", None)
+        if not user or not user.is_authenticated:
+            return Document.objects.none()
+        if user.is_superuser:
+            return Document.objects.all()
+        return get_objects_for_user_owner_aware(
+            user,
+            "documents.view_document",
+            Document,
+        )
+
+
+class CorrespondentQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = Correspondent
+    permission = "documents.view_correspondent"
+
+
+class TagQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = Tag
+    permission = "documents.view_tag"
+
+
+class DocumentTypeQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = DocumentType
+    permission = "documents.view_documenttype"
+
+
+class StoragePathQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = StoragePath
+    permission = "documents.view_storagepath"
+
+
+class SavedViewQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = SavedView
+    permission = "documents.view_savedview"
+
+
+class ShareLinkQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = ShareLink
+    permission = "documents.view_sharelink"
+
+
+class WorkflowTriggerQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = WorkflowTrigger
+    permission = "documents.view_workflowtrigger"
+
+
+class WorkflowActionQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = WorkflowAction
+    permission = "documents.view_workflowaction"
+
+
+class WorkflowQueryToolset(OwnerAwareQueryToolsetMixin, ModelQueryToolset):
+    model = Workflow
+    permission = "documents.view_workflow"
+
+
+class NoteQueryToolset(ModelQueryToolset):
+    model = Note
+
+    def get_queryset(self):
+        user = getattr(self.request, "user", None)
+        if not user or not user.is_authenticated:
+            return Note.objects.none()
+        if user.is_superuser:
+            return Note.objects.all()
+        return Note.objects.filter(
+            document__in=get_objects_for_user_owner_aware(
+                user,
+                "documents.view_document",
+                Document,
+            ),
+        )
+
+
+class CustomFieldQueryToolset(ModelQueryToolset):
+    model = CustomField
+
+    def get_queryset(self):
+        user = getattr(self.request, "user", None)
+        base = CustomField.objects.all()
+        if not user or not user.is_authenticated:
+            return base.none()
+        if user.is_superuser:
+            return base
+        return base.filter(
+            Q(
+                fields__document__id__in=get_objects_for_user_owner_aware(
+                    user,
+                    "documents.view_document",
+                    Document,
+                ),
+            )
+            | Q(fields__document__isnull=True),
+        ).distinct()
+
+
+class DocumentSearchTools(MCPToolset):
+    def search_documents(
+        self,
+        query: str | None = None,
+        more_like_id: int | None = None,
+        fields: list[str] | None = None,
+        page: int | None = None,
+        page_size: int | None = None,
+        *,
+        full_perms: bool | None = None,
+    ) -> dict:
+        """Search documents using the full-text index."""
+        if not query and not more_like_id:
+            raise ValueError("Provide either query or more_like_id.")
+
+        request = self.request
+        if request is None:
+            raise ValueError("Request context is required.")
+
+        viewset = UnifiedSearchViewSet()
+        viewset.request = request
+        viewset.args = ()
+        viewset.kwargs = {}
+        viewset.action = "list"
+        viewset.format_kwarg = None
+        viewset.check_permissions(request)
+
+        query_params = QueryDict(mutable=True)
+        if query:
+            query_params["query"] = query
+        if more_like_id:
+            query_params["more_like_id"] = str(more_like_id)
+        if full_perms is not None:
+            query_params["full_perms"] = str(full_perms).lower()
+        if page:
+            query_params["page"] = str(page)
+        if page_size:
+            query_params["page_size"] = str(page_size)
+        if fields:
+            query_params.setlist("fields", fields)
+
+        request._request.GET = query_params
+        response = viewset.list(request)
+        if isinstance(response, Response):
+            return response.data
+        if hasattr(response, "data"):
+            return response.data
+        return {
+            "detail": getattr(response, "content", b"").decode() or "Search failed.",
+        }
+
+
+drf_publish_create_mcp_tool(
+    CorrespondentViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[CorrespondentViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    CorrespondentViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[CorrespondentViewSet],
+)
+drf_publish_update_mcp_tool(
+    CorrespondentViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[CorrespondentViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    CorrespondentViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[CorrespondentViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    TagViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[TagViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    TagViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[TagViewSet],
+)
+drf_publish_update_mcp_tool(
+    TagViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[TagViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    TagViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[TagViewSet],
+)
+
+drf_publish_list_mcp_tool(
+    UnifiedSearchViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[UnifiedSearchViewSet],
+)
+drf_publish_update_mcp_tool(
+    UnifiedSearchViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[UnifiedSearchViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    UnifiedSearchViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[UnifiedSearchViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    DocumentTypeViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[DocumentTypeViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    DocumentTypeViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[DocumentTypeViewSet],
+)
+drf_publish_update_mcp_tool(
+    DocumentTypeViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[DocumentTypeViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    DocumentTypeViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[DocumentTypeViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    StoragePathViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[StoragePathViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    StoragePathViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[StoragePathViewSet],
+)
+drf_publish_update_mcp_tool(
+    StoragePathViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[StoragePathViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    StoragePathViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[StoragePathViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    SavedViewViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[SavedViewViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    SavedViewViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[SavedViewViewSet],
+)
+drf_publish_update_mcp_tool(
+    SavedViewViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[SavedViewViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    SavedViewViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[SavedViewViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    ShareLinkViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[ShareLinkViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    ShareLinkViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[ShareLinkViewSet],
+)
+drf_publish_update_mcp_tool(
+    ShareLinkViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[ShareLinkViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    ShareLinkViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[ShareLinkViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    WorkflowTriggerViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowTriggerViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    WorkflowTriggerViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowTriggerViewSet],
+)
+drf_publish_update_mcp_tool(
+    WorkflowTriggerViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowTriggerViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    WorkflowTriggerViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowTriggerViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    WorkflowActionViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowActionViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    WorkflowActionViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowActionViewSet],
+)
+drf_publish_update_mcp_tool(
+    WorkflowActionViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowActionViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    WorkflowActionViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowActionViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    WorkflowViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    WorkflowViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowViewSet],
+)
+drf_publish_update_mcp_tool(
+    WorkflowViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    WorkflowViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[WorkflowViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    CustomFieldViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[CustomFieldViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    CustomFieldViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[CustomFieldViewSet],
+)
+drf_publish_update_mcp_tool(
+    CustomFieldViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[CustomFieldViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    CustomFieldViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[CustomFieldViewSet],
+)
+
+drf_publish_list_mcp_tool(
+    TasksViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[TasksViewSet],
+)
--- a/src/documents/migrations/0006_alter_document_checksum_unique.py
+++ b/src/documents/migrations/0006_alter_document_checksum_unique.py
@@ -0,0 +1,23 @@
+# Generated by Django 5.2.7 on 2026-01-14 17:45
+
+from django.db import migrations
+from django.db import models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("documents", "0005_workflowtrigger_filter_has_any_correspondents_and_more"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="document",
+            name="checksum",
+            field=models.CharField(
+                editable=False,
+                max_length=32,
+                verbose_name="checksum",
+                help_text="The checksum of the original document.",
+            ),
+        ),
+    ]
--- a/src/documents/migrations/0007_document_content_length.py
+++ b/src/documents/migrations/0007_document_content_length.py
@@ -0,0 +1,25 @@
+# Generated by Django 5.2.6 on 2026-01-24 07:33
+
+import django.db.models.functions.text
+from django.db import migrations
+from django.db import models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("documents", "0006_alter_document_checksum_unique"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="document",
+            name="content_length",
+            field=models.GeneratedField(
+                db_persist=True,
+                expression=django.db.models.functions.text.Length("content"),
+                null=False,
+                help_text="Length of the content field in characters. Automatically maintained by the database for faster statistics computation.",
+                output_field=models.PositiveIntegerField(default=0),
+            ),
+        ),
+    ]
--- a/src/documents/models.py
+++ b/src/documents/models.py
@@ -20,7 +20,9 @@ if settings.AUDIT_LOG_ENABLED:
    from auditlog.registry import auditlog

 from django.db.models import Case
+from django.db.models import PositiveIntegerField
 from django.db.models.functions import Cast
+from django.db.models.functions import Length
 from django.db.models.functions import Substr
 from django_softdelete.models import SoftDeleteModel

@@ -192,6 +194,15 @@ class Document(SoftDeleteModel, ModelWithOwner):
        ),
    )

+    content_length = models.GeneratedField(
+        expression=Length("content"),
+        output_field=PositiveIntegerField(default=0),
+        db_persist=True,
+        null=False,
+        serialize=False,
+        help_text="Length of the content field in characters. Automatically maintained by the database for faster statistics computation.",
+    )
+
    mime_type = models.CharField(_("mime type"), max_length=256, editable=False)

    tags = models.ManyToManyField(
@@ -205,7 +216,6 @@ class Document(SoftDeleteModel, ModelWithOwner):
        _("checksum"),
        max_length=32,
        editable=False,
-        unique=True,
        help_text=_("The checksum of the original document."),
    )

@@ -946,7 +956,7 @@ if settings.AUDIT_LOG_ENABLED:
    auditlog.register(
        Document,
        m2m_fields={"tags"},
-        exclude_fields=["modified"],
+        exclude_fields=["content_length", "modified"],
    )
    auditlog.register(Correspondent)
    auditlog.register(Tag)
--- a/src/documents/permissions.py
+++ b/src/documents/permissions.py
@@ -148,13 +148,29 @@ def get_document_count_filter_for_user(user):
    )


-def get_objects_for_user_owner_aware(user, perms, Model) -> QuerySet:
-    objects_owned = Model.objects.filter(owner=user)
-    objects_unowned = Model.objects.filter(owner__isnull=True)
+def get_objects_for_user_owner_aware(
+    user,
+    perms,
+    Model,
+    *,
+    include_deleted=False,
+) -> QuerySet:
+    """
+    Returns objects the user owns, are unowned, or has explicit perms.
+    When include_deleted is True, soft-deleted items are also included.
+    """
+    manager = (
+        Model.global_objects
+        if include_deleted and hasattr(Model, "global_objects")
+        else Model.objects
+    )
+
+    objects_owned = manager.filter(owner=user)
+    objects_unowned = manager.filter(owner__isnull=True)
    objects_with_perms = get_objects_for_user(
        user=user,
        perms=perms,
-        klass=Model,
+        klass=manager.all(),
        accept_global_perms=False,
    )
    return objects_owned | objects_unowned | objects_with_perms
--- a/src/documents/serialisers.py
+++ b/src/documents/serialisers.py
@@ -23,6 +23,7 @@ from django.core.validators import MinValueValidator
 from django.core.validators import RegexValidator
 from django.core.validators import integer_validator
 from django.db.models import Count
+from django.db.models import Q
 from django.db.models.functions import Lower
 from django.utils.crypto import get_random_string
 from django.utils.dateparse import parse_datetime
@@ -72,6 +73,7 @@ from documents.models import WorkflowTrigger
 from documents.parsers import is_mime_type_supported
 from documents.permissions import get_document_count_filter_for_user
 from documents.permissions import get_groups_with_only_permission
+from documents.permissions import get_objects_for_user_owner_aware
 from documents.permissions import set_permissions_for_object
 from documents.regex import validate_regex_pattern
 from documents.templating.filepath import validate_filepath_template_and_render
@@ -82,6 +84,9 @@ from documents.validators import url_validator
 if TYPE_CHECKING:
    from collections.abc import Iterable

+    from django.db.models.query import QuerySet
+
+
 logger = logging.getLogger("paperless.serializers")


@@ -1014,6 +1019,32 @@ class NotesSerializer(serializers.ModelSerializer):
        return ret


+def _get_viewable_duplicates(
+    document: Document,
+    user: User | None,
+) -> QuerySet[Document]:
+    checksums = {document.checksum}
+    if document.archive_checksum:
+        checksums.add(document.archive_checksum)
+    duplicates = Document.global_objects.filter(
+        Q(checksum__in=checksums) | Q(archive_checksum__in=checksums),
+    ).exclude(pk=document.pk)
+    duplicates = duplicates.order_by("-created")
+    allowed = get_objects_for_user_owner_aware(
+        user,
+        "documents.view_document",
+        Document,
+        include_deleted=True,
+    )
+    return duplicates.filter(id__in=allowed)
+
+
+class DuplicateDocumentSummarySerializer(serializers.Serializer):
+    id = serializers.IntegerField()
+    title = serializers.CharField()
+    deleted_at = serializers.DateTimeField(allow_null=True)
+
+
@extend_schema_serializer(
    deprecate_fields=["created_date"],
 )
@@ -1031,6 +1062,7 @@ class DocumentSerializer(
    archived_file_name = SerializerMethodField()
    created_date = serializers.DateField(required=False)
    page_count = SerializerMethodField()
+    duplicate_documents = SerializerMethodField()

    notes = NotesSerializer(many=True, required=False, read_only=True)

@@ -1056,6 +1088,16 @@ class DocumentSerializer(
    def get_page_count(self, obj) -> int | None:
        return obj.page_count

+    @extend_schema_field(DuplicateDocumentSummarySerializer(many=True))
+    def get_duplicate_documents(self, obj):
+        view = self.context.get("view")
+        if view and getattr(view, "action", None) != "retrieve":
+            return []
+        request = self.context.get("request")
+        user = request.user if request else None
+        duplicates = _get_viewable_duplicates(obj, user)
+        return list(duplicates.values("id", "title", "deleted_at"))
+
    def get_original_file_name(self, obj) -> str | None:
        return obj.original_filename

@@ -1233,6 +1275,7 @@ class DocumentSerializer(
            "archive_serial_number",
            "original_file_name",
            "archived_file_name",
+            "duplicate_documents",
            "owner",
            "permissions",
            "user_can_change",
@@ -2094,10 +2137,12 @@ class TasksViewSerializer(OwnedObjectSerializer):
            "result",
            "acknowledged",
            "related_document",
+            "duplicate_documents",
            "owner",
        )

    related_document = serializers.SerializerMethodField()
+    duplicate_documents = serializers.SerializerMethodField()
    created_doc_re = re.compile(r"New document id (\d+) created")
    duplicate_doc_re = re.compile(r"It is a duplicate of .* \(#(\d+)\)")

@@ -2122,6 +2167,17 @@ class TasksViewSerializer(OwnedObjectSerializer):

        return result

+    @extend_schema_field(DuplicateDocumentSummarySerializer(many=True))
+    def get_duplicate_documents(self, obj):
+        related_document = self.get_related_document(obj)
+        request = self.context.get("request")
+        user = request.user if request else None
+        document = Document.global_objects.filter(pk=related_document).first()
+        if not related_document or not user or not document:
+            return []
+        duplicates = _get_viewable_duplicates(document, user)
+        return list(duplicates.values("id", "title", "deleted_at"))
+

 class RunTaskViewSerializer(serializers.Serializer):
    task_name = serializers.ChoiceField(
--- a/src/documents/tests/test_api_documents.py
+++ b/src/documents/tests/test_api_documents.py
@@ -131,6 +131,10 @@ class TestDocumentApi(DirectoriesMixin, DocumentConsumeDelayMixin, APITestCase):
        self.assertIn("content", results_full[0])
        self.assertIn("id", results_full[0])

+        # Content length is used internally for performance reasons.
+        # No need to expose this field.
+        self.assertNotIn("content_length", results_full[0])
+
        response = self.client.get("/api/documents/?fields=id", format="json")
        self.assertEqual(response.status_code, status.HTTP_200_OK)
        results = response.data["results"]
--- a/src/documents/tests/test_api_tasks.py
+++ b/src/documents/tests/test_api_tasks.py
@@ -7,6 +7,7 @@ from django.contrib.auth.models import User
 from rest_framework import status
 from rest_framework.test import APITestCase

+from documents.models import Document
 from documents.models import PaperlessTask
 from documents.tests.utils import DirectoriesMixin
 from documents.views import TasksViewSet
@@ -258,7 +259,7 @@ class TestTasks(DirectoriesMixin, APITestCase):
            task_id=str(uuid.uuid4()),
            task_file_name="task_one.pdf",
            status=celery.states.FAILURE,
-            result="test.pdf: Not consuming test.pdf: It is a duplicate.",
+            result="test.pdf: Unexpected error during ingestion.",
        )

        response = self.client.get(self.ENDPOINT)
@@ -270,7 +271,7 @@ class TestTasks(DirectoriesMixin, APITestCase):

        self.assertEqual(
            returned_data["result"],
-            "test.pdf: Not consuming test.pdf: It is a duplicate.",
+            "test.pdf: Unexpected error during ingestion.",
        )

    def test_task_name_webui(self):
@@ -325,20 +326,34 @@ class TestTasks(DirectoriesMixin, APITestCase):

        self.assertEqual(returned_data["task_file_name"], "anothertest.pdf")

-    def test_task_result_failed_duplicate_includes_related_doc(self):
+    def test_task_result_duplicate_warning_includes_count(self):
        """
        GIVEN:
-            - A celery task failed with a duplicate error
+            - A celery task succeeds, but a duplicate exists
        WHEN:
            - API call is made to get tasks
        THEN:
-            - The returned data includes a related document link
+            - The returned data includes duplicate warning metadata
        """
+        checksum = "duplicate-checksum"
+        Document.objects.create(
+            title="Existing",
+            content="",
+            mime_type="application/pdf",
+            checksum=checksum,
+        )
+        created_doc = Document.objects.create(
+            title="Created",
+            content="",
+            mime_type="application/pdf",
+            checksum=checksum,
+            archive_checksum="another-checksum",
+        )
        PaperlessTask.objects.create(
            task_id=str(uuid.uuid4()),
            task_file_name="task_one.pdf",
-            status=celery.states.FAILURE,
-            result="Not consuming task_one.pdf: It is a duplicate of task_one_existing.pdf (#1234).",
+            status=celery.states.SUCCESS,
+            result=f"Success. New document id {created_doc.pk} created",
        )

        response = self.client.get(self.ENDPOINT)
@@ -348,7 +363,7 @@ class TestTasks(DirectoriesMixin, APITestCase):

        returned_data = response.data[0]

-        self.assertEqual(returned_data["related_document"], "1234")
+        self.assertEqual(returned_data["related_document"], str(created_doc.pk))

    def test_run_train_classifier_task(self):
        """
--- a/src/documents/tests/test_consumer.py
+++ b/src/documents/tests/test_consumer.py
@@ -485,21 +485,21 @@ class TestConsumer(
        with self.get_consumer(self.get_test_file()) as consumer:
            consumer.run()

-        with self.assertRaisesMessage(ConsumerError, "It is a duplicate"):
-            with self.get_consumer(self.get_test_file()) as consumer:
-                consumer.run()
+        with self.get_consumer(self.get_test_file()) as consumer:
+            consumer.run()

-        self._assert_first_last_send_progress(last_status="FAILED")
+        self.assertEqual(Document.objects.count(), 2)
+        self._assert_first_last_send_progress()

    def testDuplicates2(self):
        with self.get_consumer(self.get_test_file()) as consumer:
            consumer.run()

-        with self.assertRaisesMessage(ConsumerError, "It is a duplicate"):
-            with self.get_consumer(self.get_test_archive_file()) as consumer:
-                consumer.run()
+        with self.get_consumer(self.get_test_archive_file()) as consumer:
+            consumer.run()

-        self._assert_first_last_send_progress(last_status="FAILED")
+        self.assertEqual(Document.objects.count(), 2)
+        self._assert_first_last_send_progress()

    def testDuplicates3(self):
        with self.get_consumer(self.get_test_archive_file()) as consumer:
@@ -513,9 +513,10 @@ class TestConsumer(

        Document.objects.all().delete()

-        with self.assertRaisesMessage(ConsumerError, "document is in the trash"):
-            with self.get_consumer(self.get_test_file()) as consumer:
-                consumer.run()
+        with self.get_consumer(self.get_test_file()) as consumer:
+            consumer.run()
+
+        self.assertEqual(Document.objects.count(), 1)

    def testAsnExists(self):
        with self.get_consumer(
@@ -718,12 +719,45 @@ class TestConsumer(
        dst = self.get_test_file()
        self.assertIsFile(dst)

-        with self.assertRaises(ConsumerError):
+        expected_message = (
+            f"{dst.name}: Not consuming {dst.name}: "
+            f"It is a duplicate of {document.title} (#{document.pk})"
+        )
+
+        with self.assertRaisesMessage(ConsumerError, expected_message):
            with self.get_consumer(dst) as consumer:
                consumer.run()

        self.assertIsNotFile(dst)
-        self._assert_first_last_send_progress(last_status="FAILED")
+        self.assertEqual(Document.objects.count(), 1)
+        self._assert_first_last_send_progress(last_status=ProgressStatusOptions.FAILED)
+
+    @override_settings(CONSUMER_DELETE_DUPLICATES=True)
+    def test_delete_duplicate_in_trash(self):
+        dst = self.get_test_file()
+        with self.get_consumer(dst) as consumer:
+            consumer.run()
+
+        # Move the existing document to trash
+        document = Document.objects.first()
+        document.delete()
+
+        dst = self.get_test_file()
+        self.assertIsFile(dst)
+
+        expected_message = (
+            f"{dst.name}: Not consuming {dst.name}: "
+            f"It is a duplicate of {document.title} (#{document.pk})"
+            f" Note: existing document is in the trash."
+        )
+
+        with self.assertRaisesMessage(ConsumerError, expected_message):
+            with self.get_consumer(dst) as consumer:
+                consumer.run()
+
+        self.assertIsNotFile(dst)
+        self.assertEqual(Document.global_objects.count(), 1)
+        self.assertEqual(Document.objects.count(), 0)

    @override_settings(CONSUMER_DELETE_DUPLICATES=False)
    def test_no_delete_duplicate(self):
@@ -743,15 +777,12 @@ class TestConsumer(
        dst = self.get_test_file()
        self.assertIsFile(dst)

-        with self.assertRaisesRegex(
-            ConsumerError,
-            r"sample\.pdf: Not consuming sample\.pdf: It is a duplicate of sample \(#\d+\)",
-        ):
-            with self.get_consumer(dst) as consumer:
-                consumer.run()
+        with self.get_consumer(dst) as consumer:
+            consumer.run()

-        self.assertIsFile(dst)
-        self._assert_first_last_send_progress(last_status="FAILED")
+        self.assertIsNotFile(dst)
+        self.assertEqual(Document.objects.count(), 2)
+        self._assert_first_last_send_progress()

    @override_settings(FILENAME_FORMAT="{title}")
    @mock.patch("documents.parsers.document_consumer_declaration.send")
--- a/src/documents/tests/test_management_exporter.py
+++ b/src/documents/tests/test_management_exporter.py
@@ -241,6 +241,10 @@ class TestExportImport(
                    checksum = hashlib.md5(f.read()).hexdigest()
                self.assertEqual(checksum, element["fields"]["checksum"])

+                # Generated field "content_length" should not be exported,
+                # it is automatically computed during import.
+                self.assertNotIn("content_length", element["fields"])
+
                if document_exporter.EXPORTER_ARCHIVE_NAME in element:
                    fname = (
                        self.target / element[document_exporter.EXPORTER_ARCHIVE_NAME]
--- a/src/documents/views.py
+++ b/src/documents/views.py
@@ -35,7 +35,6 @@ from django.db.models import Model
 from django.db.models import Q
 from django.db.models import Sum
 from django.db.models import When
-from django.db.models.functions import Length
 from django.db.models.functions import Lower
 from django.db.models.manager import Manager
 from django.http import FileResponse
@@ -2326,23 +2325,19 @@ class StatisticsView(GenericAPIView):
        user = request.user if request.user is not None else None

        documents = (
-            (
-                Document.objects.all()
-                if user is None
-                else get_objects_for_user_owner_aware(
-                    user,
-                    "documents.view_document",
-                    Document,
-                )
+            Document.objects.all()
+            if user is None
+            else get_objects_for_user_owner_aware(
+                user,
+                "documents.view_document",
+                Document,
            )
-            .only("mime_type", "content")
-            .prefetch_related("tags")
        )
        tags = (
            Tag.objects.all()
            if user is None
            else get_objects_for_user_owner_aware(user, "documents.view_tag", Tag)
-        )
+        ).only("id", "is_inbox_tag")
        correspondent_count = (
            Correspondent.objects.count()
            if user is None
@@ -2371,31 +2366,33 @@ class StatisticsView(GenericAPIView):
            ).count()
        )

-        documents_total = documents.count()
-
-        inbox_tags = tags.filter(is_inbox_tag=True)
+        inbox_tag_pks = list(
+            tags.filter(is_inbox_tag=True).values_list("pk", flat=True),
+        )

        documents_inbox = (
-            documents.filter(tags__id__in=inbox_tags).distinct().count()
-            if inbox_tags.exists()
+            documents.filter(tags__id__in=inbox_tag_pks).values("id").distinct().count()
+            if inbox_tag_pks
            else None
        )

-        document_file_type_counts = (
+        # Single SQL request for document stats and mime type counts
+        mime_type_stats = list(
            documents.values("mime_type")
-            .annotate(mime_type_count=Count("mime_type"))
-            .order_by("-mime_type_count")
-            if documents_total > 0
-            else []
+            .annotate(
+                mime_type_count=Count("id"),
+                mime_type_chars=Sum("content_length"),
+            )
+            .order_by("-mime_type_count"),
        )

-        character_count = (
-            documents.annotate(
-                characters=Length("content"),
-            )
-            .aggregate(Sum("characters"))
-            .get("characters__sum")
-        )
+        # Calculate totals from grouped results
+        documents_total = sum(row["mime_type_count"] for row in mime_type_stats)
+        character_count = sum(row["mime_type_chars"] or 0 for row in mime_type_stats)
+        document_file_type_counts = [
+            {"mime_type": row["mime_type"], "mime_type_count": row["mime_type_count"]}
+            for row in mime_type_stats
+        ]

        current_asn = Document.objects.aggregate(
            Max("archive_serial_number", default=0),
@@ -2408,11 +2405,9 @@ class StatisticsView(GenericAPIView):
                "documents_total": documents_total,
                "documents_inbox": documents_inbox,
                "inbox_tag": (
-                    inbox_tags.first().pk if inbox_tags.exists() else None
+                    inbox_tag_pks[0] if inbox_tag_pks else None
                ),  # backwards compatibility
-                "inbox_tags": (
-                    [tag.pk for tag in inbox_tags] if inbox_tags.exists() else None
-                ),
+                "inbox_tags": (inbox_tag_pks if inbox_tag_pks else None),
                "document_file_type_counts": document_file_type_counts,
                "character_count": character_count,
                "tag_count": len(tags),
--- a/src/locale/en_US/LC_MESSAGES/django.po
+++ b/src/locale/en_US/LC_MESSAGES/django.po
--- a/src/paperless/mcp.py
+++ b/src/paperless/mcp.py
@@ -0,0 +1,82 @@
+from mcp_server import drf_publish_create_mcp_tool
+from mcp_server import drf_publish_destroy_mcp_tool
+from mcp_server import drf_publish_list_mcp_tool
+from mcp_server import drf_publish_update_mcp_tool
+
+from paperless.views import ApplicationConfigurationViewSet
+from paperless.views import GroupViewSet
+from paperless.views import UserViewSet
+
+VIEWSET_ACTIONS = {
+    "create": {"post": "create"},
+    "list": {"get": "list"},
+    "update": {"put": "update"},
+    "destroy": {"delete": "destroy"},
+}
+
+BODY_SCHEMA = {"type": "object", "additionalProperties": True}
+
+VIEWSET_INSTRUCTIONS = {
+    UserViewSet: "Manage Paperless users.",
+    GroupViewSet: "Manage Paperless groups.",
+    ApplicationConfigurationViewSet: "Manage application configuration.",
+}
+
+
+drf_publish_create_mcp_tool(
+    UserViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[UserViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    UserViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[UserViewSet],
+)
+drf_publish_update_mcp_tool(
+    UserViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[UserViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    UserViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[UserViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    GroupViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[GroupViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    GroupViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[GroupViewSet],
+)
+drf_publish_update_mcp_tool(
+    GroupViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[GroupViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    GroupViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[GroupViewSet],
+)
+
+drf_publish_list_mcp_tool(
+    ApplicationConfigurationViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[ApplicationConfigurationViewSet],
+)
+drf_publish_update_mcp_tool(
+    ApplicationConfigurationViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[ApplicationConfigurationViewSet],
+    body_schema=BODY_SCHEMA,
+)
--- a/src/paperless/settings.py
+++ b/src/paperless/settings.py
@@ -348,6 +348,7 @@ INSTALLED_APPS = [
    "allauth.headless",
    "drf_spectacular",
    "drf_spectacular_sidecar",
+    "mcp_server",
    "treenode",
    *env_apps,
 ]
@@ -612,6 +613,17 @@ def _parse_remote_user_settings() -> str:

 HTTP_REMOTE_USER_HEADER_NAME = _parse_remote_user_settings()

+DJANGO_MCP_AUTHENTICATION_CLASSES = REST_FRAMEWORK["DEFAULT_AUTHENTICATION_CLASSES"]
+DJANGO_MCP_GLOBAL_SERVER_CONFIG = {
+    "name": "paperless-ngx",
+    "instructions": (
+        "Use the MCP tools to search, query, and manage Paperless-ngx data. "
+        "Use `search_documents` for full-text search, and `query_data_collections` "
+        "for structured queries against available collections. "
+        "Write operations are exposed via DRF-backed tools for create/update/delete."
+    ),
+}
+
 # X-Frame options for embedded PDF display:
 X_FRAME_OPTIONS = "SAMEORIGIN"

--- a/src/paperless/urls.py
+++ b/src/paperless/urls.py
@@ -356,6 +356,7 @@ urlpatterns = [
            ],
        ),
    ),
+    path("", include("mcp_server.urls")),
    # Root of the Frontend
    re_path(
        r".*",
--- a/src/paperless_mail/mcp.py
+++ b/src/paperless_mail/mcp.py
@@ -0,0 +1,129 @@
+from mcp_server import ModelQueryToolset
+from mcp_server import drf_publish_create_mcp_tool
+from mcp_server import drf_publish_destroy_mcp_tool
+from mcp_server import drf_publish_list_mcp_tool
+from mcp_server import drf_publish_update_mcp_tool
+
+from documents.permissions import get_objects_for_user_owner_aware
+from paperless_mail.models import MailAccount
+from paperless_mail.models import MailRule
+from paperless_mail.models import ProcessedMail
+from paperless_mail.views import MailAccountViewSet
+from paperless_mail.views import MailRuleViewSet
+from paperless_mail.views import ProcessedMailViewSet
+
+VIEWSET_ACTIONS = {
+    "create": {"post": "create"},
+    "list": {"get": "list"},
+    "update": {"put": "update"},
+    "destroy": {"delete": "destroy"},
+}
+
+BODY_SCHEMA = {"type": "object", "additionalProperties": True}
+
+VIEWSET_INSTRUCTIONS = {
+    MailAccountViewSet: "Manage mail accounts.",
+    MailRuleViewSet: "Manage mail rules.",
+    ProcessedMailViewSet: "List processed mail.",
+}
+
+
+class MailAccountQueryToolset(ModelQueryToolset):
+    model = MailAccount
+
+    def get_queryset(self):
+        user = getattr(self.request, "user", None)
+        if not user or not user.is_authenticated:
+            return MailAccount.objects.none()
+        if user.is_superuser:
+            return MailAccount.objects.all()
+        return get_objects_for_user_owner_aware(
+            user,
+            "paperless_mail.view_mailaccount",
+            MailAccount,
+        )
+
+
+class MailRuleQueryToolset(ModelQueryToolset):
+    model = MailRule
+
+    def get_queryset(self):
+        user = getattr(self.request, "user", None)
+        if not user or not user.is_authenticated:
+            return MailRule.objects.none()
+        if user.is_superuser:
+            return MailRule.objects.all()
+        return get_objects_for_user_owner_aware(
+            user,
+            "paperless_mail.view_mailrule",
+            MailRule,
+        )
+
+
+class ProcessedMailQueryToolset(ModelQueryToolset):
+    model = ProcessedMail
+
+    def get_queryset(self):
+        user = getattr(self.request, "user", None)
+        if not user or not user.is_authenticated:
+            return ProcessedMail.objects.none()
+        if user.is_superuser:
+            return ProcessedMail.objects.all()
+        return get_objects_for_user_owner_aware(
+            user,
+            "paperless_mail.view_processedmail",
+            ProcessedMail,
+        )
+
+
+drf_publish_create_mcp_tool(
+    MailAccountViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[MailAccountViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    MailAccountViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[MailAccountViewSet],
+)
+drf_publish_update_mcp_tool(
+    MailAccountViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[MailAccountViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    MailAccountViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[MailAccountViewSet],
+)
+
+drf_publish_create_mcp_tool(
+    MailRuleViewSet,
+    actions=VIEWSET_ACTIONS["create"],
+    instructions=VIEWSET_INSTRUCTIONS[MailRuleViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_list_mcp_tool(
+    MailRuleViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[MailRuleViewSet],
+)
+drf_publish_update_mcp_tool(
+    MailRuleViewSet,
+    actions=VIEWSET_ACTIONS["update"],
+    instructions=VIEWSET_INSTRUCTIONS[MailRuleViewSet],
+    body_schema=BODY_SCHEMA,
+)
+drf_publish_destroy_mcp_tool(
+    MailRuleViewSet,
+    actions=VIEWSET_ACTIONS["destroy"],
+    instructions=VIEWSET_INSTRUCTIONS[MailRuleViewSet],
+)
+
+drf_publish_list_mcp_tool(
+    ProcessedMailViewSet,
+    actions=VIEWSET_ACTIONS["list"],
+    instructions=VIEWSET_INSTRUCTIONS[ProcessedMailViewSet],
+)
--- a/uv.lock
+++ b/uv.lock
@@ -1038,6 +1038,22 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/2f/23/63a7d868373a73d25c4a5c2dd3cce3aaeb22fbee82560d42b6e93ba01403/django_guardian-3.2.0-py3-none-any.whl", hash = "sha256:0768565a057988a93fc4a1d93649c4a794abfd7473a8408a079cfbf83c559d77", size = 134674, upload-time = "2025-09-16T10:35:51.69Z" },
 ]

+[[package]]
+name = "django-mcp-server"
+version = "0.5.7"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "django", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "djangorestframework", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "inflection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "mcp", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "uritemplate", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b2/70/e2cf268b77d0aa171b72763325279284561dbbd9b80ed4fd6975b4b7bd9c/django_mcp_server-0.5.7.tar.gz", hash = "sha256:5077f8fabf5fb621b5ce490afd0db60f21e57b3a451ed14a9f44aef545ea4eee", size = 23910, upload-time = "2025-10-10T17:13:34.681Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2c/01/f78a11f51437f70b4ff2d9f131d47acf82c2a4cf78d63e9cf291e3727054/django_mcp_server-0.5.7-py3-none-any.whl", hash = "sha256:04b58bf02623aaee59708c3661ffe17981acd4532587c38b6cfe2c9e7090c6d3", size = 26389, upload-time = "2025-10-10T17:13:33.56Z" },
+]
+
 [[package]]
 name = "django-multiselectfield"
 version = "1.0.1"
@@ -1706,6 +1722,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/45/4b/2b81e876abf77b4af3372aff731f4f6722840ebc7dcfd85778eaba271733/httpx_oauth-0.16.1-py3-none-any.whl", hash = "sha256:2fcad82f80f28d0473a0fc4b4eda223dc952050af7e3a8c8781342d850f09fb5", size = 38056, upload-time = "2024-12-20T07:23:00.394Z" },
 ]

+[[package]]
+name = "httpx-sse"
+version = "0.4.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/0f/4c/751061ffa58615a32c31b2d82e8482be8dd4a89154f003147acee90f2be9/httpx_sse-0.4.3.tar.gz", hash = "sha256:9b1ed0127459a66014aec3c56bebd93da3c1bc8bb6618c8082039a44889a755d", size = 15943, upload-time = "2025-10-10T21:48:22.271Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/fd/6668e5aec43ab844de6fc74927e155a3b37bf40d7c3790e49fc0406b6578/httpx_sse-0.4.3-py3-none-any.whl", hash = "sha256:0ac1c9fe3c0afad2e0ebb25a934a59f4c7823b60792691f779fad2c5568830fc", size = 8960, upload-time = "2025-10-10T21:48:21.158Z" },
+]
+
 [[package]]
 name = "huggingface-hub"
 version = "0.30.2"
@@ -2378,6 +2403,30 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/be/2f/5108cb3ee4ba6501748c4908b908e55f42a5b66245b4cfe0c99326e1ef6e/marshmallow-3.26.2-py3-none-any.whl", hash = "sha256:013fa8a3c4c276c24d26d84ce934dc964e2aa794345a0f8c7e5a7191482c8a73", size = 50964, upload-time = "2025-12-22T06:53:51.801Z" },
 ]

+[[package]]
+name = "mcp"
+version = "1.26.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "httpx", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "httpx-sse", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "jsonschema", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "pydantic-settings", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "pyjwt", extra = ["crypto"], marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "python-multipart", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "sse-starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "typing-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "uvicorn", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fc/6d/62e76bbb8144d6ed86e202b5edd8a4cb631e7c8130f3f4893c3f90262b10/mcp-1.26.0.tar.gz", hash = "sha256:db6e2ef491eecc1a0d93711a76f28dec2e05999f93afd48795da1c1137142c66", size = 608005, upload-time = "2026-01-24T19:40:32.468Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fd/d9/eaa1f80170d2b7c5ba23f3b59f766f3a0bb41155fbc32a69adfa1adaaef9/mcp-1.26.0-py3-none-any.whl", hash = "sha256:904a21c33c25aa98ddbeb47273033c435e595bbacfdb177f4bd87f6dceebe1ca", size = 233615, upload-time = "2026-01-24T19:40:30.652Z" },
+]
+
 [[package]]
 name = "mdurl"
 version = "0.1.2"
@@ -2937,6 +2986,7 @@ dependencies = [
    { name = "django-extensions", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
    { name = "django-filter", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
    { name = "django-guardian", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "django-mcp-server", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
    { name = "django-multiselectfield", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
    { name = "django-soft-delete", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
    { name = "django-treenode", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
@@ -3085,6 +3135,7 @@ requires-dist = [
    { name = "django-extensions", specifier = "~=4.1" },
    { name = "django-filter", specifier = "~=25.1" },
    { name = "django-guardian", specifier = "~=3.2.0" },
+    { name = "django-mcp-server", specifier = "~=0.5.7" },
    { name = "django-multiselectfield", specifier = "~=1.0.1" },
    { name = "django-soft-delete", specifier = "~=1.0.18" },
    { name = "django-treenode", specifier = ">=0.23.2" },
@@ -3790,6 +3841,20 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/88/9d/b06ca6acfe4abb296110fb1273a4d848a0bfb2ff65f3ee92127b3244e16b/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f14f8f046c14563f8eb3f45f499cc658ab8d10072961e07225e507adb700e93f", size = 2316992, upload-time = "2025-11-04T13:43:43.602Z" },
 ]

+[[package]]
+name = "pydantic-settings"
+version = "2.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "python-dotenv", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "typing-inspection", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/4b/ac7e0aae12027748076d72a8764ff1c9d82ca75a7a52622e67ed3f765c54/pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0", size = 194184, upload-time = "2025-11-10T14:25:47.013Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/60/5d4751ba3f4a40a6891f24eec885f51afd78d208498268c734e256fb13c4/pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809", size = 51880, upload-time = "2025-11-10T14:25:45.546Z" },
+]
+
 [[package]]
 name = "pygments"
 version = "2.19.2"
@@ -4007,6 +4072,15 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/6c/73/9f872cb81fc5c3bb48f7227872c28975f998f3e7c2b1c16e95e6432bbb90/python_magic-0.4.27-py2.py3-none-any.whl", hash = "sha256:c212960ad306f700aa0d01e5d7a325d20548ff97eb9920dcd29513174f0294d3", size = 13840, upload-time = "2022-06-07T20:16:57.763Z" },
 ]

+[[package]]
+name = "python-multipart"
+version = "0.0.22"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/94/01/979e98d542a70714b0cb2b6728ed0b7c46792b695e3eaec3e20711271ca3/python_multipart-0.0.22.tar.gz", hash = "sha256:7340bef99a7e0032613f56dc36027b959fd3b30a787ed62d310e951f7c3a3a58", size = 37612, upload-time = "2026-01-25T10:15:56.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1b/d0/397f9626e711ff749a95d96b7af99b9c566a9bb5129b8e4c10fc4d100304/python_multipart-0.0.22-py3-none-any.whl", hash = "sha256:2b2cd894c83d21bf49d702499531c7bafd057d730c201782048f7945d82de155", size = 24579, upload-time = "2026-01-25T10:15:54.811Z" },
+]
+
 [[package]]
 name = "pytz"
 version = "2025.2"
@@ -4948,6 +5022,32 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/a9/5c/bfd6bd0bf979426d405cc6e71eceb8701b148b16c21d2dc3c261efc61c7b/sqlparse-0.5.3-py3-none-any.whl", hash = "sha256:cf2196ed3418f3ba5de6af7e82c694a9fbdbfecccdfc72e281548517081f16ca", size = 44415, upload-time = "2024-12-10T12:05:27.824Z" },
 ]

+[[package]]
+name = "sse-starlette"
+version = "3.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "starlette", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/8b/8d/00d280c03ffd39aaee0e86ec81e2d3b9253036a0f93f51d10503adef0e65/sse_starlette-3.2.0.tar.gz", hash = "sha256:8127594edfb51abe44eac9c49e59b0b01f1039d0c7461c6fd91d4e03b70da422", size = 27253, upload-time = "2026-01-17T13:11:05.62Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/96/7f/832f015020844a8b8f7a9cbc103dd76ba8e3875004c41e08440ea3a2b41a/sse_starlette-3.2.0-py3-none-any.whl", hash = "sha256:5876954bd51920fc2cd51baee47a080eb88a37b5b784e615abb0b283f801cdbf", size = 12763, upload-time = "2026-01-17T13:11:03.775Z" },
+]
+
+[[package]]
+name = "starlette"
+version = "0.52.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "typing-extensions", marker = "(python_full_version < '3.13' and sys_platform == 'darwin') or (python_full_version < '3.13' and sys_platform == 'linux')" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c4/68/79977123bb7be889ad680d79a40f339082c1978b5cfcf62c2d8d196873ac/starlette-0.52.1.tar.gz", hash = "sha256:834edd1b0a23167694292e94f597773bc3f89f362be6effee198165a35d62933", size = 2653702, upload-time = "2026-01-18T13:34:11.062Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/81/0d/13d1d239a25cbfb19e740db83143e95c772a1fe10202dda4b76792b114dd/starlette-0.52.1-py3-none-any.whl", hash = "sha256:0029d43eb3d273bc4f83a08720b4912ea4b071087a3b48db01b7c839f7954d74", size = 74272, upload-time = "2026-01-18T13:34:09.188Z" },
+]
+
 [[package]]
 name = "sympy"
 version = "1.13.3"
@@ -5108,13 +5208,13 @@ dependencies = [
    { name = "typing-extensions", marker = "sys_platform == 'darwin'" },
 ]
 wheels = [
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp310-none-macosx_11_0_arm64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp311-none-macosx_11_0_arm64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp312-none-macosx_11_0_arm64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp313-cp313t-macosx_11_0_arm64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp313-none-macosx_11_0_arm64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp314-cp314-macosx_11_0_arm64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp314-cp314t-macosx_11_0_arm64.whl" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp310-none-macosx_11_0_arm64.whl", hash = "sha256:bf1e68cfb935ae2046374ff02a7aa73dda70351b46342846f557055b3a540bf0" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp311-none-macosx_11_0_arm64.whl", hash = "sha256:a52952a8c90a422c14627ea99b9826b7557203b46b4d0772d3ca5c7699692425" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp312-none-macosx_11_0_arm64.whl", hash = "sha256:287242dd1f830846098b5eca847f817aa5c6015ea57ab4c1287809efea7b77eb" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:8924d10d36eac8fe0652a060a03fc2ae52980841850b9a1a2ddb0f27a4f181cd" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp313-none-macosx_11_0_arm64.whl", hash = "sha256:bcee64ae7aa65876ceeae6dcaebe75109485b213528c74939602208a20706e3f" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:defadbeb055cfcf5def58f70937145aecbd7a4bc295238ded1d0e85ae2cf0e1d" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:886f84b181f766f53265ba0a1d503011e60f53fff9d569563ef94f24160e1072" },
 ]

 [[package]]
@@ -5138,20 +5238,20 @@ dependencies = [
    { name = "typing-extensions", marker = "sys_platform == 'linux'" },
 ]
 wheels = [
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp310-cp310-manylinux_2_28_aarch64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp310-cp310-manylinux_2_28_x86_64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp311-cp311-manylinux_2_28_aarch64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp311-cp311-manylinux_2_28_x86_64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp312-cp312-manylinux_2_28_aarch64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp312-cp312-manylinux_2_28_x86_64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313-manylinux_2_28_aarch64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313-manylinux_2_28_x86_64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313t-manylinux_2_28_aarch64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313t-manylinux_2_28_x86_64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314-manylinux_2_28_aarch64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314-manylinux_2_28_x86_64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314t-manylinux_2_28_aarch64.whl" },
-    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314t-manylinux_2_28_x86_64.whl" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:10866c8a48c4aa5ae3f48538dc8a055b99c57d9c6af2bf5dd715374d9d6ddca3" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:7210713b66943fdbfcc237b2e782871b649123ac5d29f548ce8c85be4223ab38" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:0e611cfb16724e62252b67d31073bc5c490cb83e92ecdc1192762535e0e44487" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:3de2adb9b4443dc9210ef1f1b16da3647ace53553166d6360bbbd7edd6f16e4d" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:3bf9b442a51a2948e41216a76d7ab00f0694cfcaaa51b6f9bcab57b7f89843e6" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:7417d8c565f219d3455654cb431c6d892a3eb40246055e14d645422de13b9ea1" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:3e532e553b37ee859205a9b2d1c7977fd6922f53bbb1b9bfdd5bdc00d1a60ed4" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:39b3dff6d8fba240ae0d1bede4ca11c2531ae3b47329206512d99e17907ff74b" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:01b1884f724977a20c7da2f640f1c7b37f4a2c117a7f4a6c1c0424d14cb86322" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:031a597147fa81b1e6d79ccf1ad3ccc7fafa27941d6cf26ff5caaa384fb20e92" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314-manylinux_2_28_aarch64.whl", hash = "sha256:65010ab4aacce6c9a1ddfc935f986c003ca8638ded04348fd326c3e74346237c" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314-manylinux_2_28_x86_64.whl", hash = "sha256:88adf5157db5da1d54b1c9fe4a6c1d20ceef00e75d854e206a87dbf69e3037dc" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:3ac2b8df2c55430e836dcda31940d47f1f5f94b8731057b6f20300ebea394dd9" },
+    { url = "https://download.pytorch.org/whl/cpu/torch-2.9.1%2Bcpu-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:5b688445f928f13563b7418b17c57e97bf955ab559cf73cd8f2b961f8572dbb3" },
 ]

 [[package]]
@@ -5495,6 +5595,20 @@ wheels = [
    { url = "https://files.pythonhosted.org/packages/5d/34/257747253ad446fd155e39f0c30afda4597b3b9e28f44a9de5dee76a6509/uv-0.9.6-py3-none-musllinux_1_1_x86_64.whl", hash = "sha256:b31377ebf2d0499afc5abe3fe1abded5ca843f3a1161b432fe26eb0ce15bab8e", size = 21597889, upload-time = "2025-10-29T19:40:36.963Z" },
 ]

+[[package]]
+name = "uvicorn"
+version = "0.40.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "click", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "h11", marker = "sys_platform == 'darwin' or sys_platform == 'linux'" },
+    { name = "typing-extensions", marker = "(python_full_version < '3.11' and sys_platform == 'darwin') or (python_full_version < '3.11' and sys_platform == 'linux')" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c3/d1/8f3c683c9561a4e6689dd3b1d345c815f10f86acd044ee1fb9a4dcd0b8c5/uvicorn-0.40.0.tar.gz", hash = "sha256:839676675e87e73694518b5574fd0f24c9d97b46bea16df7b8c05ea1a51071ea", size = 81761, upload-time = "2025-12-21T14:16:22.45Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3d/d8/2083a1daa7439a66f3a48589a57d576aa117726762618f6bb09fe3798796/uvicorn-0.40.0-py3-none-any.whl", hash = "sha256:c6c8f55bc8bf13eb6fa9ff87ad62308bbbc33d0b67f84293151efe87e0d5f2ee", size = 68502, upload-time = "2025-12-21T14:16:21.041Z" },
+]
+
 [[package]]
 name = "uvloop"
 version = "0.21.0"
Author	SHA1	Message	Date
shamoon	902ad8303b	Feature: mcp server	2026-01-27 00:20:45 -08:00
GitHub Actions	6997a2ab8b	Auto translate strings	2026-01-26 20:58:22 +00:00
Jan Kleine	f82f31f383	Enhancement: improve relative dates in date filter (#11899 )	2026-01-26 12:56:29 -08:00
GitHub Actions	ac76710296	Auto translate strings	2026-01-26 20:12:45 +00:00
Antoine Mérino	df07b8a03e	Performance: faster statistics panel on dashboard (#11760 )	2026-01-26 12:10:57 -08:00
GitHub Actions	cac1b721b9	Auto translate strings	2026-01-26 18:57:50 +00:00
shamoon	4428354150	Feature: allow duplicates with warnings, UI for discovery (#11815 )	2026-01-26 18:55:08 +00:00