All servers / Media / Lightroom Classic MCP server
Lightroom Classic MCP server
MCP server bridging Claude/Codex/ChatGPT to Adobe Lightroom Classic via a Lua plugin.
Tested by ConnectATDScore 90 out of 100. Tested 2026-11-19 on package version 0.27.0. Package: @mskalski/lightroom-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (2.3 seconds including download)
- Tools offered: 33
- Last published: 2026-11-05
- Weekly downloads (npm): 1,086
- License: MIT · Direct dependencies: 3
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
search_photos17 of 17 parameters describedSearch photos using intersecting Library filters (paginated, default limit 100): filename, keywords, rating, capture date, camera, lens, ISO, focal length, flag, color label, edited status, file type and folder. Provide at least one filter to improve performance on large catalogs.
get_selected_photos3 of 3 parameters describedGet currently selected photos in Lightroom (or filmstrip if no selection). Paginated, default limit 100.
get_photo_metadata3 of 3 parameters describedRead 1-100 photos: keywords/nested keywordPaths, EXIF, title/caption/headline, GPS latitude/longitude/altitude, IPTC sublocation/city/stateProvince/country/isoCountryCode, copyright, accessibility alt_text/extended_description (LrC 13.2+, omitted empty/unsupported), and optional developSettings. IDs are catalog local. isVirtualCopy marks copies; optional virtualCopy contains masterPhotoId or master copyIds. Optional folder stack contains position (top=1), isCollapsed, topPhotoId and ordered memberIds. developSettings is absent by default; request sections: ["developSettings"] to read it. Empty sections omits it; duplicates are accepted. developSettings covers every set_develop_settings key: basic/tone/parametric curves use camelCase; hsl/lens/transform/crop/detail/effects/parametricSplits use SDK names; empty groups are omitted.
get_photo_preview3 of 3 parameters describedLightroom-rendered JPEG with Develop edits (raw supported). region crops the rendered frame after develop crop/rotation: normalized x/y/width/height, origin top-left, x right, y down. width/height/bytes are actual; requested_size is the source request. See size for cost/edge rules.
get_photo_previews2 of 2 parameters describedGet JPEG thumbnails for 1–20 photos in input order for culling. Maps requested_id/photo_id to 1-based image_index; errors have no image and do not fail the batch. Default size 256; max edge 2000px; total budget 8 MiB. After 20 s returns complete:false and remaining_ids to retry. Catalog unchanged.
find_duplicate_groups3 of 3 parameters describedGroup near-duplicates/bursts from up to 100 IDs/paths using 64-bit dHash of current JPEG previews (minimum edge 64) and raw capture time. Every pair must meet inclusive time_window_seconds (default 5) and max_hamming_distance (default 10). Input-order groups omit singletons and repeated photos; IDs are resolved. Approximate similarity does not rank frames. photos gives raw capture_time in Lightroom seconds (second precision, no timezone normalization). No hash cache or catalog changes. At 25 s returns partial groups, complete=false, remaining_ids; preview/missing-time failures are unprocessed with reasons. Retry remaining IDs with originals to grow groups.
get_photo_stats1 of 1 parameter describedMeasure current rendered JPEG previews for up to 20 photos; result/error per input ID. histogram: 64 normalized Rec.709 luma bins (0-255, four levels/bin); mean_luminance same scale; shadow_fraction <=1, highlight_fraction >=254. sharpness: four-neighbor Laplacian variance after area resampling to 512px long edge (enlarges small previews); higher=sharper. These measure JPEG previews, not raw clipping/full-resolution focus. Catalog unchanged.
set_gps5 of 5 parameters describedReplace GPS coordinates in decimal degrees. Altitude stays unless altitude or clear_altitude is given. Returns success, updated and missing IDs.
set_location6 of 6 parameters describedSet IPTC location fields from get_photo_metadata; at least one is required. Omitted fields stay, empty strings clear. GPS stays (use set_gps). Returns success, updated, fields and missing IDs.
set_metadata11 of 11 parameters describedSet IPTC text from get_photo_metadata. Accessibility needs LrC 13.2+. At least one field; omitted fields stay, empty strings clear. Copyright status is unwritable. Returns success, updated, fields and missing IDs.
set_ai_metadata1 of 3 parameters describedStore an AI score and reason in private per-photo plug-in metadata in this catalog. Provide score, reason or both. Score is an integer from 0 to 100; reason is at most 1024 characters. Omitted fields stay unchanged; an empty string clears a field. Does not change IPTC, XMP, keywords, or export metadata.
get_ai_metadata1 of 1 parameter describedRead private per-photo AI scores and reasons in one batch (up to 1000 IDs or paths). Returns photos with photo_id, numeric score and reason; unset fields are omitted. Missing IDs are reported separately.
list_folders2 of 2 parameters describedList catalog folders in tree order as a paginated flat list of full paths, names and photo_count (direct photos only, excluding subfolders). Default limit 100.
get_folder_photos4 of 4 parameters describedList photos in a catalog folder by its full path from list_folders (paginated, default limit 100). Subfolders are excluded by default.
list_collections2 of 2 parameters describedList all collections in Lightroom catalog (paginated, default limit 100)
create_collection2 of 2 parameters describedCreate a collection; returns success and its path.
create_smart_collection16 of 16 parameters describedSave intersecting search_photos filters as an auto-updating smart collection; at least one filter. Creates missing parent sets; rejects existing sibling names. Returns success and path.
add_to_collection2 of 2 parameters describedAdd photos to a collection; returns success, added count and missing IDs.
get_collection_photos4 of 4 parameters describedList the photos in a collection, regular or smart (paginated, default limit 100). Use a path from list_collections when names repeat; an ambiguous bare name is rejected.
remove_from_collection2 of 2 parameters describedRemove photos from a regular collection; catalog and other memberships stay. Returns success, removed (unique members), not_in_collection and missing IDs.
delete_collection1 of 1 parameter describedDelete a collection; photos stay in the catalog. Returns success, photo_count and that reminder.
set_keywords4 of 4 parameters describedAdd/remove keyword names or parent-first '|' paths from list_keywords, ignoring case. Missing names create top-level keywords; paths create missing levels unless create_missing=false. Returns success, updated count and missing IDs; a call matching no photo creates no keyword.
remove_keyword_subtree3 of 3 parameters describedDetach a parent keyword and every descendant from photo_ids, or all tagged photos with catalog_wide=true. Matches paths ignoring case; unknown parent fails unchanged. Preserves unrelated and same-named keywords elsewhere. Keyword nodes stay in the catalog and list_keywords. Use a dedicated parent such as 'AI Keywords' with set_keywords to undo a tagging batch. Returns updated photo count, removed assignment count and missing IDs.
list_keywords5 of 5 parameters describedList paginated parent-first keyword paths ('Places|Europe|Paris'), synonyms and include-on-export (limit default 100). Pass paths to set_keywords; narrow large trees with parent/query or request paths_only.
rename_keyword2 of 2 parameters describedRename in place; tagged photos update, parent/children/synonyms stay. Case-insensitive sibling conflicts fail; case-only renames work. Returns success, old_path, new_path and photo_count.
undo_last_step1 of 1 parameter describedUndo one shared Lightroom history step (confirm:true), including a user/other plug-in action after your edit. Ownership is unknown: call only if undoing the current last step is acceptable. Lightroom can merge recent plug-in writes, even across photos, into one step. Returns undone, can_undo and message.
set_rating_and_flag3 of 3 parameters describedSet rating, flag, or both in one write. Returns success, updated and missing; get_photo_metadata reports rating and pickStatus (pick 1, reject -1, none 0).
set_color_label2 of 2 parameters describedSet a color label or none to clear; get_photo_metadata reports colorLabel. Returns success, updated and missing IDs.
remove_photos_from_catalog2 of 2 parameters describedRemove up to 100 IDs/paths from catalog, losing catalog edits/metadata; files remain on disk (LrC 14.3+, confirm:true). Include every virtual copy with its master; a path shared by a master and copies is refused, so use numeric IDs. Deduplicates; reports missing IDs. Opens Library grid on the photos' folders (All Photographs if one is not found), restores module/sources/surviving selection; Library stays in grid view.
import_photos4 of 4 parameters describedImport a photo or a folder recursively. A JPEG with a non-DNG raw file of exactly the same name (only the extension's case may differ) stays the raw's sidecar: folders leave it out and report skipped_sidecar_jpegs; importing that JPEG alone fails and names the raw. Lightroom makes no sidecar for other JPEGs, so they import as their own photos. Files already in the catalog are left unchanged and counted in already_in_catalog. A file whose folder differs only in case from another catalog folder (possible on a case-sensitive volume) fails, because Lightroom would file it under that other folder. A file whose name differs only in case from a catalog photo in the same folder fails too, because Lightroom keeps file names case-insensitively and cannot hold both; on a case-insensitive volume it is the same file and counts in already_in_catalog. Lightroom and Photos library packages are skipped. Returns success, imported/skipped counts, failed per file, added_to_collection, skipped_by_extension, skipped_sidecar_jpegs, skipped_package_files, already_in_catalog, complete and remaining_paths. Only unsupported-extension notes remain in message.
export_photos9 of 9 parameters describedExport photos, optionally with a saved export preset; format/quality/width/height override only those preset settings. Skips the preset's collision prompt and after-export action. A photo with outdated AI settings can open Lightroom's AI Updates dialog, which blocks until dismissed. Returns success, exported and skipped counts, failed, missing IDs, destination, preset, complete and remaining_ids to retry.
list_export_presets1 of 1 parameter describedList saved export presets (not Lightroom's built-ins) with folder, file, id, format, quality, size, file_naming and destination. Only usable: true (Hard Drive) presets work with export_photos; others give unusable_reason.
export_photo_metadata3 of 3 parameters describedExport up to 1000 photos to disk JSON: file/capture time/dimensions/rating/title/caption/GPS/location/keywords/keywordPaths, no develop settings. Omitted photo_ids uses selection, or filmstrip if none. Prefer over per-photo get_photo_metadata. Returns success, exported, destination and missing IDs.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.