Skip to main content
skill CX Codex

immich-photo-manager — Claude Code skill: features and install

The immich-photo-manager Claude Code skill manages a self-hosted Immich photo library through natural-language requests. It searches images and text in photos, and helps organize albums, duplicates, and metadata.

MIT 105 installs ★ 3,785 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-code
Open on GitHub

What immich-photo-manager does

The skill connects an agent to a self-hosted Immich instance and provides tools for working with its photo library. Search by image content, text found in photos, people, places, or dates; group images into albums using location data; and detect duplicates across sources. The package includes 94 MCP tools and 13 skills.

It can also repair metadata, manage face assignments, and extract frames from video clips. Albums or selected images can become PDF photobooks, while search results can open in HTML galleries. Before changes are made, the skill presents its findings and asks for confirmation. Sending items to trash is separate from permanent deletion.

Immich 1.90 or later, an API key, and Python 3.10+ are required.

What it helps with

  • find images from a scene description or text in a photo
  • group travel photos into albums by location
  • spot duplicates from different import sources
  • repair capture times and missing GPS data
  • create a PDF photobook from an album

Example prompts for the agent

  • Find the photo with the train ticket.
  • Create albums for the places I traveled to.
  • Make a PDF photobook from the Sintra album.

How to install immich-photo-manager

1Skills CLI (Vercel)

npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-code

2Manually: put the files in place

~/.claude/skills/immich-photo-manager/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/immich-photo-manager/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about immich-photo-manager

How do I install immich-photo-manager in Claude Code?

Run npx skills add davepoon/buildwithclaude --skill immich-photo-manager -a claude-code. The skill file is at ~/.claude/skills/immich-photo-manager/SKILL.md.

What does immich-photo-manager do?

It gives an agent tools to search and organize an Immich photo library. It also handles duplicates, people, metadata, video frames, and PDF photobooks.

What does immich-photo-manager require?

It requires Immich 1.90 or later, an API key, and Python 3.10+.

Source text

SKILL.md · MIT
---
name: immich-photo-manager
category: storage-docs
description: "Manage your self-hosted Immich photo library through conversation: natural language and OCR search, geographic album curation, duplicate detection, people and faces, metadata repair, video frames and PDF photobooks. 94 MCP tools and 13 skills, tested live on Immich 2.x and 3.x. Install: claude plugin install immich-photo-manager"
---

# Immich Photo Manager

> MCP server and Claude Code plugin for intelligent photo management with self-hosted [Immich](https://immich.app).

## Overview

When your Immich library has grown past what you can manage by hand, this plugin gives Claude direct access to your instance through 94 MCP tools and 13 skills. Search with natural language or by the text inside a photo, create geographic albums from GPS data, find duplicates across import sources, manage people and faces, repair metadata, cut frames out of videos, export an album as a PDF photobook, and browse results in interactive HTML galleries. The plugin runs on your machine and talks only to your Immich; originals never leave your server.

## Key Features

- **Natural language search**: CLIP visual search ("sunset at the beach", "birthday cake"), plus people, places, dates and camera filters
- **Text inside photos**: OCR search finds a ticket, a sign or a document by what is written on it
- **Geographic albums**: albums organized by place from GPS clustering and temporal matching
- **Duplicate detection**: cross-source analysis with perceptual hashing (catches re-encoded copies from Apple Photos and Google Takeout); near-duplicates can be stacked instead of deleted
- **People and faces**: list, search, merge and rename people, reassign misidentified faces
- **Metadata repair**: fix noon and midnight timestamps, infer missing GPS from neighboring photos, correct timezone offsets
- **Video frames and PDF reports**: evenly spaced frames from any clip, and an album or selection exported as a PDF photobook with captions, built locally
- **Dates in one call**: month buckets, a calendar heatmap that shows gaps, and Immich's "on this day" memories
- **Library health**: asset inventory, metadata quality, storage breakdown and recommendations
- **Notes between sessions**: verdicts stored on each asset, so the next cleanup skips what an earlier pass reviewed
- **Interactive galleries**: self-contained HTML files with embedded thumbnails, 3 themes, 4 view modes, slideshow
- **Safety first**: findings are shown and confirmed before anything is written; trash first, permanent delete only on request

## Compatibility

Every release runs live against real Immich 2.7.5 and 3.1.0 in Docker before it is tagged (all tools over MCP, state re-read after each write); the kit is in the repository under `tests/live/`. Works with Claude Code, Claude Desktop, LM Studio and any MCP client. Requires Immich 1.90+, an API key and Python 3.10+.

## Installation

```bash
git clone https://github.com/drolosoft/immich-photo-manager.git
cd immich-photo-manager
pip3 install -r src/requirements.txt
claude plugin marketplace add ./
claude plugin install immich-photo-manager
```

Then run `/setup-immich-photo-manager` inside Claude Code, or say "Update my Immich credentials to https://photos.example.com with API key <key>". The same server is available as `uvx immich-photo-manager` for other MCP clients and as a Docker image (`ghcr.io/drolosoft/immich-photo-manager`, MCP over HTTP on port 8626).

## Usage

```
"How healthy is my photo library?"
"Show me my photos from Italy"
"Find the photo with the train ticket"
"Create albums for everywhere I've traveled"
"Find duplicates in my library and keep the best of each group"
"Make me a PDF of the Sintra album"
/cleanup: scan for screenshots and junk
/my-travels: discover all travel destinations
```

## Skills

photo-search, photo-cleanup, duplicate-report, auto-album-curator, album-manager, album-report, travel-map, metadata-fixer, storage-optimizer, library-health-report, people-report, rotate-photos, timeline-gaps.

## Links

- **Repository**: https://github.com/drolosoft/immich-photo-manager
- **Tools reference**: https://github.com/drolosoft/immich-photo-manager/blob/main/doc/MCP-TOOLS.md
- **Demos from real sessions**: https://github.com/drolosoft/immich-photo-manager/blob/main/doc/demos/README.md
- **Author**: [Drolosoft](https://drolosoft.com)
- **License**: MIT

© davepoon · MIT · davepoon/buildwithclaude

Similar skills

All skills for Writing and docs →

From the same set235

The whole set →
square-automation square-automation automates Square operations: payments, orders, invoices, and locations via Rube MCP. Use it to search transactions, update order status, and manage invoices from your editor. CX Codex +1 119installs clawring clawring allows your agent to place outbound phone calls for urgent notifications, alerts, and voice briefings without Twilio setup. CX Codex +1 112installs x-twitter-scraper x-twitter-scraper — a skill for extracting X (Twitter) data via Xquik API: tweet search, user profiles, followers, trends, account monitoring with webhooks. 22 MCP tools included. CX Codex +1 107installs recap The recap skill for Claude Code and Cursor generates a narrative financial review for any time period using MCP tools. CX Codex +1 105installs tidy This Claude Code skill groups uncategorized transactions and suggests categories. It starts when asked to tidy transactions or sort uncategorized activity. CX Codex +1 104installs google-drive-upload google-drive-upload is a Claude Code skill that sends files to Google Drive through a deployed Google Apps Script web app. It reacts to requests to store or upload a file. CX Codex +1 101installs szamlazz-invoicing The szamlazz-invoicing Claude Code skill handles Hungarian invoices through the szamlazz.hu Agent API. It activates for requests to issue, cancel, or download an invoice, or create a proforma. CX Codex +1 100installs optimize-database-performance optimize-database-performance — a slash command that works through slow queries, index strategy and schema layout for PostgreSQL and MySQL, then hands back SQL you can apply. Useful once page loads start dragging. CX Codex +1 ★ 3,785repo stars

Project sponsors

Companies that keep this analytics open