Immich Smart Curator: AI-Powered Photo Management & Automated Gallery Publishing

A next-generation MCP (Model Context Protocol) server that transforms your Immich photo library into a living, breathing digital archive. Imagine having a personal photo curator who never sleeps—automatically organizing your memories into intelligent geographic albums, detecting duplicates with surgical precision, and publishing polished galleries for the world to see. Welcome to the future of photo management.

---

Quick Start: Two Minutes to a Smarter Library

Example Profile Configuration

# config/profile.yaml
server:
  name: "smart-curator"
  version: "1.0.0"
  immich:
    host: "https://your-immich-instance.local"
    api_key: "${IMMICH_API_KEY}"
  curation:
    duplicate_threshold: 0.85
    geo_clustering_radius_km: 50
    auto_publish: true
  ai:
    provider: "openai" # or "claude"
    api_key: "${AI_API_KEY}"

Example Console Invocation

$ immich-smart-curator --profile config/profile.yaml \
  --action scan-library \
  --target-album "2026 Summer Adventures" \
  --publish-conflicts auto-merge

---

System Architecture Diagram

graph TD
    A[Immich Photo Library] --> B[Smart Curator MCP Server]
    B --> C[Duplicate Detection Engine]
    B --> D[Geographic Clustering Module]
    B --> E[Gallery Publisher]
    C --> F[Conflict Resolution AI]
    D --> G[Map Tile Generator]
    E --> H[Public Gallery CDN]
    F --> I[OpenAI API / Claude API]
    G --> J[Leaflet.js Interactive Maps]
    H --> K[Responsive Web Gallery]
    style B fill:#4CAF50,color:white
    style C fill:#2196F3,color:white
    style D fill:#FF9800,color:white
    style E fill:#9C27B0,color:white

---

✨ Feature List: What Makes This Different?

• Intelligent Duplicate Hunting 🕵️ – Scans perceptual hashes and metadata to find near-identical photos, even across different resolutions or crops.
• Geographic Album Curation 🗺️ – Automatically groups photos based on GPS coordinates, creating travel albums that tell a story of your journey.
• One-Click Gallery Publishing 📤 – Exports curated collections as standalone, responsive web galleries deployable to any static hosting service.
• AI-Powered Conflict Resolution 🤖 – When duplicates or overlapping albums are detected, the AI (OpenAI or Claude) proposes the best merge strategy.
• Multilingual Metadata Support 🌍 – Reads and writes metadata in 50+ languages, ensuring your Japanese cherry blossom photos are tagged correctly even if your system language is English.
• 24/7 Daemon Mode 🕐 – Runs as a background service, continuously monitoring your Immich library for new imports and applying curation rules automatically.
• Responsive Web Galleries 📱 – Galleries look stunning on mobile, tablet, and desktop with built-in lazy loading and image optimization.
• Privacy-First Architecture 🔒 – All AI processing happens via encrypted API calls; no photos are ever stored on third-party servers.

---

🖥️ OS Compatibility

Operating System	2026 Support	Recommended RAM	Notes
Windows 11/10	✅	4 GB	Native binary
macOS Sonoma+	✅	4 GB	Homebrew install
Ubuntu 24.04+	✅	2 GB	Docker or snap
Fedora 40+	✅	2 GB	RPM package
Raspberry Pi OS	✅	1 GB	ARM64 build
Docker (any host)	✅	2 GB	Recommended

---

🔌 API Integration: OpenAI & Claude