Repolode
Submit
drolosoft

drolosoft/immich-photo-manager

MCP server and Claude Code plugin that lets AI assistants search, organize, deduplicate and curate photos in a self-hosted Immich library.

Open-source alternative to:Google Photos

View on GitHubWebsite
Stars
62
Forks
11
Open issues
1
Last commit
2 days ago

What is it?

immich-photo-manager is an MCP server and Claude Code plugin that connects an AI assistant to a self-hosted Immich photo server through Immich's public API. It exposes 94 tools covering natural-language search with CLIP and OCR, album creation (including geographic albums built from GPS, visual search and dates), duplicate detection, people and face management, metadata repair such as timestamp and timezone fixes, and trash handling.

The server runs locally on your machine and talks only to the Immich instance you configure. Read operations that return thumbnails send those images to the model you use, so with a cloud assistant the thumbnails leave your network; a local model over MCP keeps everything inside. Destructive actions like deletion show findings and wait for confirmation first.

Beyond the Claude Code plugin, the server works with any MCP-compatible client over stdio or Streamable HTTP, and ships as a Docker image. It also exports PDF photobooks with video frames and self-contained HTML galleries. The author states the project is tested live against Immich 2.7.5 and 3.1.0.

Key features

  • 01Natural-language photo search using CLIP and OCR text inside images
  • 02Geographic and themed album creation combining GPS, visual search and dates
  • 03Duplicate detection with perceptual hashing across imported libraries
  • 04Metadata repair for timestamps, timezones and missing GPS
  • 05People and face management, including merging and reassigning faces
  • 06PDF photobook and interactive HTML gallery export

Use cases

  • Organizing a large self-hosted Immich library through an AI assistant
  • Building trip or location albums from GPS and dates in one request
  • Finding and cleaning up duplicate or low-quality photos after importing from several services
  • Running a fully local assistant against Immich with a model such as Gemma via LM Studio

Quick start

  1. 1

    Clone the repository

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

    Install the Python dependencies from the cloned folder

    pip3 install -r src/requirements.txt
  3. 3

    Add the plugin marketplace from the cloned folder

    claude plugin marketplace add ./
  4. 4

    Install the plugin in Claude Code, then run /setup-immich-photo-manager to connect your Immich server

    claude plugin install immich-photo-manager

Things to know

  • You need a running self-hosted Immich server and an API key before it does anything.
  • Requires Python 3.10 or newer.
  • Thumbnails the assistant views are sent to the model you use; with Claude they leave your network.

In collections

MCP servers for Claude CodeSelf-hosted photo librariesClaude Code tools, skills & pluginsMCP serversSelf-hosted apps

Topics

#immich#mcp#photo-management#self-hosted#claude#geolocation#deduplication#ai-assistant#albums#claude-plugin

FAQ

What is immich-photo-manager?
MCP server and Claude Code plugin that lets AI assistants search, organize, deduplicate and curate photos in a self-hosted Immich library. immich-photo-manager is an MCP server and Claude Code plugin that connects an AI assistant to a self-hosted Immich photo server through Immich's public API. It exposes 94 tools covering natural-language search with CLIP and OCR, album creation (including geographic albums built from GPS, visual search and dates), duplicate detection, people and face management, metadata repair such as timestamp and timezone fixes, and trash handling.
Is immich-photo-manager free to use? What license does it have?
immich-photo-manager is open source under the MIT license. Check the license terms before using it in commercial products.
Is immich-photo-manager still maintained?
Actively maintained. The last commit to immich-photo-manager was on Nov 5, 2026.
What can I use immich-photo-manager for?
Organizing a large self-hosted Immich library through an AI assistant Building trip or location albums from GPS and dates in one request Finding and cleaning up duplicate or low-quality photos after importing from several services Running a fully local assistant against Immich with a model such as Gemma via LM Studio
How do I install immich-photo-manager?
Clone the repository: git clone https://github.com/drolosoft/immich-photo-manager.git Install the Python dependencies from the cloned folder: pip3 install -r src/requirements.txt Add the plugin marketplace from the cloned folder: claude plugin marketplace add ./ Install the plugin in Claude Code, then run /setup-immich-photo-manager to connect your Immich server: claude plugin install immich-photo-manager
Where can I get immich-photo-manager?
The source code and installation instructions are on GitHub: https://github.com/drolosoft/immich-photo-manager

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects