Skip to content
TakoAPI
Back to skills

immich-api

by ninjazan420

Image & Video Generation
472Downloads reported by clawskills.sh
4Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Immich Photo Management API Bridge.

Description

What This Skill Does

A bridge for interacting with self-hosted Immich photo management instances via REST API. Covers assets, albums, libraries, users, search, and background jobs. Supports both environment variable and CLI argument configuration.

Exposes the full Immich REST API through a pre-configured bridge, so automations don't require manually constructing auth headers or endpoint paths each time.

When to Use It

  • Bulk uploading a folder of photos to Immich
  • Downloading a specific album to local storage
  • Searching photos by keyword across a library
  • Triggering thumbnail regeneration jobs
  • Listing and managing users on a shared Immich instance

Example Workflow

INPUT

User asks: upload all photos from ./vacation folder to a new album called 'Summer 2025'

AGENT
  1. 1

    Authenticate against the Immich instance using IMMICH_API_KEY and IMMICH_URL

  2. 2

    Create a new album named 'Summer 2025' via POST /api/albums

  3. 3

    Run upload_photos.py targeting the ./vacation folder

  4. 4

    Retrieve the uploaded asset IDs and add them to the new album

  5. 5

    Confirm album contents via GET /api/albums/{albumId}

OUTPUT

Album 'Summer 2025' created and populated with all photos from the vacation folder

Requirements

  • IMMICH_URL environment variable pointing to a running Immich instance
  • IMMICH_API_KEY generated from Immich user profile settings
  • Self-hosted Immich instance (immich.app)

Installation

clawhub install ninjazan420/immich-api

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links