Claude Code plugin

Immich Photo Manager

MCP server and Claude Code plugin for self-hosted Immich: CLIP and OCR search, geographic albums, duplicates, people and faces, metadata repair, PDF photobooks. 94 tools, tested live on Immich 2.x and 3.x.

62 stars 11 forksPlugins & marketplaces Plugin marketplace Source

Install

Install
claude plugin marketplace add ./

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/drolosoft/immich-photo-manager.git

From the README

immich-photo-manager
MCP server for intelligent photo management with Immich: your self-hosted library, understood.
An unofficial community plugin by Drolosoft. It is not affiliated with, sponsored by or endorsed by Immich or FUTO; "Immich" is their name and is used here only to say which server the plugin works with. It talks to your Immich server through its public API.

If your Immich library has grown past what you can manage by hand, immich-photo-manager gives any AI assistant direct access to your instance: search, organize, deduplicate, and curate albums through natural conversation. Works with Claude, Gemma, or any MCP-compatible client. Runs locally and talks only to your Immich; your originals stay on your server (see what leaves your network).
Tested, not assumed. Every push runs 364 unit tests on CI. Every release is also run live against real Immich 2.7.5 and 3.1.0 (Docker, all 94 tools over the MCP protocol's legacy era, state re-read after each write) before it is tagged; both protocol eras (the legacy handshake and stateless 2026-07-28) are pinned on every push by SDK-free wire tests (tests/test_raw_wire_eras.py). The kit is in tests/live/, reproducible by anyone. The demos in doc/demos/ are transcripts of real sessions, Demo 11 is this exact flow prompt by prompt, and Demo 12 runs the video frames and PDF photobook on a real clip. Demos 13 to 18 cover everything added in 2.x (library discovery, OCR and people search, memories and stacks, partners and downloads, asset notes, the Docker image) from real sessions. Details: How it's tested.

What It Does

Say "create albums for all my trips" and watch it work:

GPS coordinates, CLIP visual search, and temporal matching, combined in one request to create dozens of curated albums. No scripts, no manual…
Read the full README on GitHub

How plugins work

  • A plugin bundles slash commands, subagents, skills, hooks, MCP servers and status lines so they install together.
  • Add the marketplace inside Claude Code with /plugin marketplace add drolosoft/immich-photo-manager, then run /plugin to pick what to install.
  • You can turn a plugin off again from /plugin without deleting anything.
Claude Code docs

Details

Language
Python
License
MIT
Last updated
6 October 2026
Topics
albumsclaudeclaude-plugincleanupduplicatesgallerygeolocationimmichimmich-pluginmcpmcp-servermetadata

FAQ

What is Immich Photo Manager?

MCP server and Claude Code plugin for self-hosted Immich: CLIP and OCR search, geographic albums, duplicates, people and faces, metadata repair, PDF photobooks. 94 tools, tested live on Immich 2.x and 3.x. It is a plugin for Claude Code, from drolosoft/immich-photo-manager on GitHub.

How do I install Immich Photo Manager?

Run claude plugin marketplace add ./, then follow the setup in the README.

Is Immich Photo Manager popular?

drolosoft/immich-photo-manager has 62 GitHub stars and 11 forks, and is included in 1 curated Claude Code list. It was last updated on 6 October 2026.

More plugins & marketplaces

Browse the most popular Claude Code mods, all plugins & marketplaces, or the skills and MCP server directories.