Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LIGHTROOM_ROOT | No | Overrides the default Lightroom support directory during install. | |
| LIGHTROOM_VENV_DIR | No | Overrides the Python runtime location. | |
| LIGHTROOM_AUTO_LAUNCH | No | Opens Lightroom automatically when the managed server starts when set to 1. | |
| LIGHTROOM_WRITE_PREFS | No | Skips the automatic Lightroom plugin-loader preference update when set to 0. | |
| LIGHTROOM_SKIP_INSTALL | No | Skips plugin reinstall when set to 1. | |
| LIGHTROOM_WAIT_SECONDS | No | Changes the bridge wait timeout (in seconds). | 180 |
| LIGHTROOM_FORCE_RESTART | No | Force restarts Lightroom before launch when set to 1. | |
| LIGHTROOM_BOOTSTRAP_PYTHON | No | Chooses the Python executable used for venv creation (e.g., python3.12). |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lightroom_ping | Verify Lightroom bridge connectivity and plugin health. |
| lightroom_status | Get plugin status, command count, and socket state. |
| lightroom_list_commands | List command names currently exposed by the Lightroom plugin. |
| get_selected_photos | List selected Lightroom photos with IDs and key metadata. |
| get_active_photo | Get the active Lightroom photo in the current selection. |
| get_active_photo_file | Get active photo metadata plus direct file-inspection details. |
| find_photo_by_path | Find one Lightroom catalog photo by absolute file path. |
| get_selected_photo_files | List selected Lightroom photos with direct file-inspection details. |
| get_develop_settings | Get all ~175 develop settings for the active photo (or first in local_ids). Returns a settings dict with every slider value: exposure, contrast, HSL, split toning, tone curve, sharpening, noise reduction, effects, etc. Call this before editing to understand the photo's current state. |
| get_develop_param_range | Get slider range for a develop parameter (when Lightroom can report it). |
| list_develop_parameters | List develop parameters known by this Lightroom Classic install. |
| list_develop_param_ranges | Get numeric ranges for known develop parameters (where available). |
| apply_develop_settings | Apply one or many develop settings to selected photos or local_ids. Settings is a dict of parameter names to values, e.g.: {"Exposure": 0.5, "Contrast": 25, "SplitToningHighlightHue": 35} Use strict=True to reject unknown parameters. clamp=True (default) auto-clamps to valid ranges. history_name creates a named undo step in Lightroom. |
| set_develop_param | Set a single develop parameter across selected photos or local_ids. |
| list_develop_groups | List grouped develop parameter sets for faster targeted edits. |
| get_develop_group_settings | Get only the settings for one named develop group. |
| set_develop_group | Apply a partial update to one develop parameter group. |
| list_develop_presets | List built-in editing presets that can be applied in one call. |
| apply_develop_preset | Apply a named preset with optional parameter overrides. |
| batch_apply_develop_operations | Run multiple preset/settings/parameter/group operations in sequence. Each operation is a dict with one of: preset, settings, parameter, or group. Examples: [{"preset": "portrait_clean"}, {"settings": {"Exposure": 0.3}}, {"parameter": "Contrast", "value": 20}] Operations run in order. Use stop_on_error=True to halt on first failure. default_local_ids applies to all operations unless overridden per-operation. |
| auto_tone | Run Auto Tone style adjustments for selected photos or local_ids. |
| auto_white_balance | Set white balance to Auto for selected photos or local_ids. |
| reset_current_photo | Reset all develop adjustments on the currently active photo. |
| set_rating | Set Lightroom star rating (0..5). |
| set_label | Set Lightroom color label name (or empty string to clear). |
| set_pick_status | Set pick flag: -1 reject, 0 unflag, 1 pick. |
| set_title | Set Lightroom title metadata for selected photos or local_ids. |
| set_caption | Set Lightroom caption metadata for selected photos or local_ids. |
| add_keywords | Add keywords (supports hierarchical format: A > B > C). |
| remove_keywords | Remove keywords by name/path from selected photos or local_ids. |
| select_mask_tool | Select a mask tool: brush, graduated-filter, radial-filter, or range-mask. |
| create_ai_mask | Create an AI-powered mask on the active photo. mask_type: subject, sky, background, person, object, depth, luminance, color operation: new (default), add, subtract, intersect |
| select_mask | Select an existing mask by its numeric ID. |
| get_local_adjustment_settings | Read local_* adjustment parameters on the currently active mask. Returns values for local_Exposure, local_Contrast, local_Highlights, etc. A mask must be active (selected) first. |
| apply_local_adjustment_settings | Set local_* adjustment parameters on the currently active mask. Settings dict uses local_* parameter names, e.g.: {"local_Exposure": 1.5, "local_Contrast": 25, "local_Clarity": 40} A mask must be active (selected) first. |
| toggle_mask_overlay | Toggle the mask overlay visualization on/off. |
| invert_mask | Invert the active mask (or a specific mask by ID). |
| list_local_params | List available local_* adjustment parameters for masks. |
| undo | Undo the last Lightroom operation. |
| redo | Redo the last undone Lightroom operation. |
| can_undo | Check if undo/redo operations are available. |
| create_snapshot | Create a named develop snapshot for the active photo. |
| list_snapshots | List develop snapshots for the active photo. |
| apply_snapshot | Apply a develop snapshot by its ID. |
| delete_snapshot | Delete a develop snapshot by its ID. |
| list_collections | List all collections and collection sets in the catalog. |
| create_collection | Create a new collection (optionally inside a collection set). |
| add_to_collection | Add selected photos (or specific local_ids) to a collection. |
| remove_from_collection | Remove selected photos (or specific local_ids) from a collection. |
| delete_collection | Delete a collection by its ID. |
| create_virtual_copy | Create virtual copies of selected photos or specific local_ids. |
| rotate_left | Rotate selected photos 90 degrees left. |
| rotate_right | Rotate selected photos 90 degrees right. |
| list_lightroom_presets | List Lightroom's built-in and user-created develop presets. |
| apply_lightroom_preset | Apply a Lightroom develop preset by its UUID. |
| toggle_lens_blur_depth_viz | Toggle the lens blur depth visualization overlay. |
| set_lens_blur_bokeh | Set the lens blur bokeh shape. |
| export_photos | Export photos as JPG to a destination folder. Exports selected photos (or specific local_ids) with all develop edits applied as sRGB JPEG files to the given folder path. Creates the folder if it doesn't exist. |
| send_raw_lightroom_command | Send a raw command to the plugin (advanced/debug use). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |