Skip to content

feat: add parent tag support for hierarchical tag structures#5

Open
zagah wants to merge 1 commit intobarryw:mainfrom
zagah:feat/parent-tag-support
Open

feat: add parent tag support for hierarchical tag structures#5
zagah wants to merge 1 commit intobarryw:mainfrom
zagah:feat/parent-tag-support

Conversation

@zagah
Copy link
Copy Markdown

@zagah zagah commented Apr 14, 2026

Summary

  • Adds optional parent field to Tag, TagCreateRequest, and TagUpdateRequest models
  • Exposes parent as an optional parameter on paperless_tags_create and paperless_tags_update MCP tools
  • No breaking changes — parent defaults to null everywhere

Background

Paperless-ngx supports nested/hierarchical tags via a parent ID on the API. This PR makes that capability accessible through the MCP interface, allowing AI assistants to create and manage tag hierarchies (e.g. a Taxes parent tag with 2023, 2024 children).

Test plan

  • Build succeeds with zero warnings
  • Existing tag tests pass unchanged
  • Manual: create a child tag with parent=<id> and verify Paperless stores the hierarchy correctly

🤖 Generated with Claude Code

Adds optional parent field to Tag, TagCreateRequest, and TagUpdateRequest
models, and exposes it as an optional parameter on the paperless_tags_create
and paperless_tags_update MCP tools.

Paperless-ngx supports nested tags via a parent ID; this change makes that
capability accessible through the MCP interface.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant