I

immich-photo-manager

drolosoft/immich-photo-manager · v2.0.13 · Tools & Integrations

by drolosoftOwner verifiedScan grade: caution

MCP server and Claude Code plugin for self-hosted Immich photo libraries: CLIP and OCR search, geographic album curation, duplicate detection, people and faces, metadata repair, video frames and PDF photobooks, 94 tools and 13 skills tested live on Immich 2.x and 3.x, also via uvx or Docker

Follow0
Protect this install with HOL Guard

Guard checks the skills and MCP servers a plugin adds on your machine and asks you before a risky action runs. The scores above are free, and no plan changes them.

Is immich-photo-manager a fit?

From the plugin's manifest and HOL's scan. Anything the plugin does not declare is shown as not declared.

Works with

  • Claude Code
  • MCP
  • 13 skills
  • 1 MCP server

Before you install

Sign-in
Not declared
Settings it asks for
Immich server URL, Immich API key (secret)
Declared access
Not declared
License
MIT

Check before relying on it

What is immich-photo-manager?

immich-photo-manager is a published tools & integrations plugin for AI coding agents that works with Claude Code and MCP, developed by drolosoft and distributed through the HOL AI plugin registry. MCP server and Claude Code plugin for self-hosted Immich photo libraries: CLIP and OCR search, geographic album curation, duplicate detection, people and faces, metadata repair, video frames and PDF photobooks, 94 tools and 13 skills tested live on Immich 2.x and 3.x, also via uvx or Docker.

Canonical slug
drolosoft/immich-photo-manager
Version
v2.0.13 · updated Oct 6, 2026

Registry snapshot

Support the project
Buy Me a Coffee
Owner verification
Verified on HOL as @juanatsap
Scanner
Registry fallback scan
Security result
Caution
Digest verified
Yes
13 bundled skillsRead, copy or download each SKILL.mdOpen skills

Trust and security

Trust & reputation

On-Chain Verified
65

HOL Trust Score

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
64/100
Maintenance
55/100
MCP server setup
100/100
Plugin Security
59/100
Provenance
80/100
Publisher Quality
100/100

Provenance

Plugin root
.
Source repo
https://github.com/drolosoft/immich-photo-manager
Source commit
22dd58280d13…
Publisher verified
Yes
Owner verified
@juanatsap

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

README badge not detected

Plugin owners can add the HOL badge to the repository README from Guard Plugins. Distribution, not security evidence. It adds a 2% engagement adjustment to the overall trust score and never changes the security result.

Caution
Security result
59
Security score
0
High findings
Provider
registry-broker-fallback
Grade
F · caution
Version
Unknown
cisco-skill-scanner: unknown

Published advisories

None matched in GitHub security advisories, checked . This covers published advisories only, not problems nobody has reported.

GitHub security advisories are those the source repository has published.

Findings

mediumpublishabilitypublishability.link.missing.websiteURL

websiteURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.privacyPolicyURL

privacyPolicyURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

lowoperational-securitysupply-chain.lockfile-missing

Repository snapshot does not include a lockfile.

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

Install guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs

Optional: install HOL Guard for Claude Code first, so it can check this plugin's tools on your machine before Claude Code uses them.

  1. 1

    Add the marketplace

    Run this inside a Claude Code session. It registers the marketplace manifest shipped at the repository root. If the repository ships none, add the generated entry from the Advanced section below first.

    claude code
  2. 2

    Find the marketplace and plugin names

    The install id is <plugin-entry>@<marketplace-name>, and the marketplace name is declared inside the manifest — it can differ from the repository name. List registered marketplaces to read both names.

    shell
  3. 3

    Install the plugin

    Substitute the plugin entry name and the marketplace name shown by the previous step.

    claude code

Did setup work in Claude Code?

No setup reports for Claude Code yet. Self-reported by signed-in visitors. Copying a command is not counted, and most installs are never reported.

Attested installs: Fewer than 10 attested installs of this plugin in week 2026-W43, so no number is shown. Counted from opt-in HOL Guard install reports, once per machine and runtime, and never mixed with the answers above. How install reports work.

Loading reviews

Plugin manifest

{
  "name": "immich-photo-manager",
  "displayName": "Photo Manager for Immich",
  "version": "2.0.13",
  "description": "MCP server for intelligent photo management with Immich — interactive HTML galleries with Cowork Actions Panel, geographic album curation, library cleanup, duplicate detection, people & face management, tags, uploads, shared links, trash management, metadata repair, PDF reports, and 94 MCP tools. Unofficial community plugin by Drolosoft, not affiliated with or endorsed by Immich or FUTO.",
  "mcpServers": "./.registry/mcp.json",
  "author": {
    "name": "Drolosoft",
    "email": "[email protected]",
    "url": "https://drolosoft.com"
  },
  "repository": "https://github.com/drolosoft/immich-photo-manager",
  "homepage": "https://drolosoft.com",
  "documentationUrl": "https://github.com/drolosoft/immich-photo-manager/blob/main/doc/GETTING-STARTED.md",
  "supportUrl": "https://github.com/drolosoft/immich-photo-manager/issues",
  "privacyPolicyUrl": "https://github.com/drolosoft/immich-photo-manager#what-leaves-your-network",
  "license": "MIT",
  "icon": "./assets/icon.png",
  "keywords": [
    "immich",
    "photos",
    "gallery",
    "self-hosted",
    "photo-management",
    "albums",
    "geographic",
    "cleanup",
    "duplicates",
    "metadata",
    "mcp",
    "claude"
  ],
  "userConfig": {
    "immich_base_url": {
      "type": "string",
      "title": "Immich server URL",
      "description": "Where your Immich lives, for example https://photos.example.com. Leave it empty to set it later with /setup-immich-photo-manager.",
      "default": ""
    },
    "immich_api_key": {
      "type": "string",
      "title": "Immich API key",
      "description": "An API key from your Immich user settings. Stored in your system's secure storage, never in a file of the plugin. Leave it empty to set it later with /setup-immich-photo-manager.",
      "sensitive": true,
      "default": ""
    }
  },
  "interface": {
    "displayName": "Photo Manager for Immich",
    "developerName": "drolosoft"
  },
  "skills": "./",
  "holManifestOrigin": "repository",
  "registryIndexVersion": 5
}

Marketplace source

Repo URL
https://github.com/drolosoft/immich-photo-manager
Marketplace path
Unknown
Source path
.
Install policy
Unspecified

Skills

13 SKILL.md files ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli
  • album-manager

    skills/album-manager/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • album-report

    skills/album-report/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • auto-album-curator

    skills/auto-album-curator/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • duplicate-report

    skills/duplicate-report/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • library-health-report

    skills/library-health-report/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • metadata-fixer

    skills/metadata-fixer/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • people-report

    skills/people-report/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • photo-cleanup

    skills/photo-cleanup/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • photo-search

    skills/photo-search/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • rotate-photos

    skills/rotate-photos/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • storage-optimizer

    skills/storage-optimizer/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • timeline-gaps

    skills/timeline-gaps/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

  • travel-map

    skills/travel-map/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

File inventory

.claude-plugin/mcp.json

file

394 bytes

90de316a8811e4f9…

.claude-plugin/plugin.json

file

1,957 bytes

6cbff5d73cf162c5…

.codex-plugin/plugin.json

plugin-manifest

1,864 bytes

542e3c0d728e5918…

.registry/mcp.json

mcp-config

287 bytes

1ccb30ec95417be4…

commands/cleanup.md

file

2,339 bytes

36eff3bc1924c9c6…

commands/create-album.md

file

1,799 bytes

dacdd5b206e05d93…

commands/immich-status.md

file

1,611 bytes

42b5569a8c3ad643…

commands/my-travels.md

file

2,146 bytes

51cefcbe4c854f5f…

commands/setup-immich-photo-manager.md

file

7,347 bytes

afde3a25adb86b4a…

README.md

file

26,228 bytes

89ac2de8687490dd…

SECURITY.md

file

1,365 bytes

822f32458f300f8c…

skills/album-manager/references/geographic-search-patterns.md

skill

5,424 bytes

62168a8f90bad0e6…

skills/album-manager/references/viewer-template-spec.md

skill

7,415 bytes

aece8aca4112ca4f…

skills/album-manager/SKILL.md

skill

13,635 bytes

dd58a40f85407e53…

skills/album-report/SKILL.md

skill

4,672 bytes

9b7178efcbb4c48b…

skills/auto-album-curator/SKILL.md

skill

7,146 bytes

bc0456eaa91dcfd7…

skills/duplicate-report/SKILL.md

skill

10,123 bytes

53176902ee221e89…

skills/library-health-report/SKILL.md

skill

7,737 bytes

a0b3214ab9966243…

skills/metadata-fixer/SKILL.md

skill

8,628 bytes

925df3bb54083d20…

skills/people-report/SKILL.md

skill

7,813 bytes

893f1585b5dd1ed3…

skills/photo-cleanup/SKILL.md

skill

8,636 bytes

d01d488bc6e21ee8…

skills/photo-search/SKILL.md

skill

14,840 bytes

2da3dbca32f30a22…

skills/rotate-photos/SKILL.md

skill

5,282 bytes

a62512214a6bb477…

skills/storage-optimizer/SKILL.md

skill

8,341 bytes

1116161d564087b8…

skills/timeline-gaps/SKILL.md

skill

7,672 bytes

d2a5981fb5ab6ba7…

skills/travel-map/SKILL.md

skill

9,997 bytes

8c8088465d6e5142…

immich-photo-manager — Frequently asked questions

What is immich-photo-manager?
immich-photo-manager is an AI plugin in the HOL registry. MCP server and Claude Code plugin for self-hosted Immich photo libraries: CLIP and OCR search, geographic album curation, duplicate detection, people and faces, metadata repair, video frames and PDF photobooks, 94 tools and 13 skills tested live on Immich 2.x…
How do I install immich-photo-manager?
Install immich-photo-manager in your harness: Claude Code — /plugin marketplace add drolosoft/immich-photo-manager; MCP — git clone https://github.com/drolosoft/immich-photo-manager; Any agent — npx [email protected] add drolosoft/immich-photo-manager. Full step-by-step guidance is on the HOL plugin page.
How do I install immich-photo-manager in Claude Code?
To install immich-photo-manager in Claude Code, start with /plugin marketplace add drolosoft/immich-photo-manager. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
How do I install immich-photo-manager in MCP?
To install immich-photo-manager in MCP, start with git clone https://github.com/drolosoft/immich-photo-manager. The complete step-by-step install guide for MCP is on the HOL plugin page.
How is the Trust Score for immich-photo-manager computed?
immich-photo-manager has a HOL Trust Score of 65 out of 100. The score is a weighted sum of six components from a static scan of the source, capped for high-severity findings and adjusted by two disclosed policies. Memberships and payments are not inputs, and a scan is not a safety guarantee. Full breakdown: https://hol.org/registry/plugins/drolosoft%2Fimmich-photo-manager/trust
Who publishes immich-photo-manager?
immich-photo-manager is published by drolosoft and listed on HOL.

Install signal

HOL cannot see every install. These are separate signals from different sources, so they are not added together. Counts under each floor show as <N.

Install commands issued here
<5
HOL Guard install commands issued from this listing, last 28 days.
Opt-in install reports
<10
Machines that reported installing it through HOL Guard in week 2026-W43. Reporting is opt-in, so most installs are not counted.
HOL Guard workspaces
<5
Workspaces that approved it or include it in an approved-plugin feed, as of today.
New GitHub stars
11
From HOL's GitHub snapshots of the repository, 2026-10-06 to 2026-10-31.

Reviews and similar plugins