lr-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LR_MCP_HOME | No | Directory to store state (e.g., .env and tokens). Defaults to ~/.config/lr-mcp or $XDG_CONFIG_HOME/lr-mcp if set. | |
| LR_MCP_PORT | No | Sign-in callback port. | 8000 |
| ADOBE_CLIENT_ID | Yes | Client ID (also called API key) for the Adobe Lightroom API. | |
| ADOBE_CLIENT_SECRET | Yes | Client secret for the Adobe Lightroom API. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lr_loginA | Sign in to Adobe in the browser and store tokens. Only needed when another tool reports that the user is not signed in or the token refresh failed. Waits up to 5 minutes for the user to finish signing in. |
| lr_accountA | Account info: subscription status and cloud storage usage. |
| lr_list_albumsB | List albums as 'Folder / Album' paths with their ids. query: case-insensitive substring of the path, e.g. 'kyoto' or '2024'. Folders are tagged [folder]; project albums created by this server are tagged [project]. |
| lr_list_photosA | List photos matching filters, oldest capture first. album_id: search inside one album; omit to search the whole catalog (then narrow it with captured_after). captured_after / captured_before: 'YYYY-MM-DD' or 'YYYY-MM-DDTHH:MM:SS'. min_rating: minimum star rating (1-5). flag: 'pick' or 'reject'. camera / lens / filename: case-insensitive substrings. min_iso: minimum ISO. hour_from / hour_to: time of day in the camera's local capture time, 0-23 inclusive; wraps past midnight when hour_from > hour_to (e.g. 19 and 4 for night shots). max_fnumber / min_fnumber: f-number bounds, e.g. max_fnumber=2 for f/2 or wider, min_fnumber=8 for f/8 or narrower. Useful when lens info is missing (manual lenses). Photos without the needed capture time or f-number are excluded when these are set. Each line: id | file | captured | rating | flag | exposure | camera + lens |
| lr_get_photoB | Details for one photo: capture info, rating/flag, original file, and a summary of its edits. |
| lr_view_photosA | Fetch photos as images to look at them (JPEG with edits applied). Up to 12 per call. size: 'thumbnail2x' (small, for scanning many) | '640' | '1280' | '2048'. |
| lr_download_photosA | Save photos as JPEG files. Pass either asset_ids or album_id (the whole album). size: '640' | '1280' | '2048' | '2560' | 'fullsize' (original resolution with edits; slower). dest_dir defaults to ~/Downloads/lightroom/. Files are named after the original file name with a .jpg extension. |
| lr_create_project_albumB | Create a project album owned by this server (shown under Connections in Lightroom). Adds asset_ids right away if given. |
| lr_add_to_project_albumB | Add photos to a project album. Albums the user created cannot be modified. |
| lr_delete_project_albumA | Delete a project album created by this server. Only the album is removed; photos stay in the catalog. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools target a distinct resource+action; the only mild overlap is lr_view_photos vs lr_download_photos, both fetch image data, but their purposes (look/view vs save to disk) are stated clearly. Album tools are cleanly separated by action (add, create, delete, list).
Nearly all names follow lr_ + verb_noun (list_photos, get_photo, create_project_album, delete_project_album, download_photos, view_photos), with only lr_account breaking the verb pattern as a noun-only query and lr_add_to_project_album using a preposition. Still predictable and readable overall.
10 tools is well-scoped for a Lightroom client covering discovery, viewing, download, album management, authentication, and account info. Each tool earns its place with a clear role.
Core read and album-creation workflows are covered, but there are notable gaps: no tool to update photo rating/flag or remove a photo from an album, and no album rename/move. These missing mutations will limit common editing and organization workflows.