Lightroom Classic MCP
An MCP server linking an agent to a Lightroom Classic catalog: photo search, ratings, develop settings, collections, export.
- 202 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The agent changes ratings, metadata, develop settings and masks in a live catalog.
- Export writes files to disk.
Install
- Works in
Manual install
claude mcp add lightroom -- npx -y @mskalski/lightroom-mcpThe Claude Code option from the README. Claude Desktop has a `.mcpb` file install, and Codex uses `codex mcp add lightroom -- npx -y @mskalski/lightroom-mcp`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent changes ratings, metadata, develop settings and masks in a live catalog.
- Export writes files to disk.
This is third-party code. Review the repository files before installing.
What it does
Lightroom Classic MCP links an agent to the catalog open in the application through a Lightroom plug-in. The agent searches photos by conditions, sets ratings and keywords, changes develop settings and masks, manages collections and imports and exports pictures. There are first-pass culling and iterative preset workflows: preset versions can be compared and checkpoints saved. Only core catalog and metadata tools are on by default. The `LIGHTROOM_MCP_TOOLSETS` variable (`develop`, `masks`, `all`) adds the rest, and `LIGHTROOM_MCP_READ_ONLY=true` hides and blocks write tools. A Claude Code plugin ships the `raw-photo-lightroom-preset` skill.
Who it is for. Photographers who keep a catalog in Lightroom Classic and want to hand culling, tagging and preset tuning to an agent.
Good fit when
- After a shoot, frames must be culled by rating and selected photos tagged with keywords.
- One preset is compared across several pictures and its versions tracked.
- Selected frames are exported to JPEG at a given size.
- The catalog must only be read: read-only mode is on.
Not a fit when
- Lightroom Classic is not installed: the server works only with it.
- You need operations missing from the plug-in SDK: HDR and panorama merges, Super Resolution, folder creation.
- The catalog is valuable and has no backup.
Example request
Find my five-star photos from last summer, add the keyword "portfolio" to the selected ones and export them to the Desktop as JPEG 2000 px wide.MCP
- Transport
- stdio
- Authentication
- not required
Environment variables
`LIGHTROOM_MCP_TOOLSETS`- Tool sets: `core` by default, `develop`, `masks` or `all`.
`LIGHTROOM_MCP_READ_ONLY`- A value of `true` or `1` hides and blocks write tools.
Limitations
Lightroom Classic on macOS or Windows is required, open and with the plug-in running (Plug-in Manager, Start Server button). The npm server needs Node.js 20 or newer. Adobe's SDK does not expose raw histograms, pixel data, HDR and panorama merges, Super Resolution or folder creation in the catalog. AI-based edits cannot be moved by copying a settings table, because the data lives in `.acr` files. Masks are written in an undocumented format, so before editing the server checks the version and tries to restore previous masks on a mismatch.
How to disable. Remove the `lightroom` entry from the MCP configuration and disable the plug-in in Plug-in Manager. The local access token sits in `~/.config/lightroom-mcp/token`.
FAQ
How do I limit writes?
Set `LIGHTROOM_MCP_READ_ONLY=true`: write tools are hidden and calls to them are refused before reaching Lightroom.
How do I enable develop and masks?
The `LIGHTROOM_MCP_TOOLSETS` variable accepts `develop`, `masks`, `develop,masks` or `all`. The core set stays on.
Does deleting a collection delete photos?
No. `delete_collection` removes the collection and the pictures stay in the catalog.
Is there an easy install for Claude Desktop?
Yes. Download the `.mcpb` file from the latest release, open it by double-click and confirm, then enable the plug-in in Lightroom.
Is it reachable from the network?
No. The connection is local and needs a 256-bit token the plug-in creates when the server starts.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server for Adobe Photoshop: background removal, retouch, social export and batch jobs by chat
An MCP server that edits images through Photopea: layers, text, effects and export, 46 tools for Claude Code and Cursor.
The MCP server gives agents GIMP image editing with visual previews, layers, filters and file export operations.
MCP for Adobe Premiere Pro: editing through an agent
MCP for Adobe Premiere Pro
A local MCP server that lets Claude, Cursor and Codex read a Premiere Pro project, edit the timeline and export the result
An MCP server for Windows that drives an installed Photoshop: documents, layers and arbitrary JSX scripts
MCP server and panel let an agent read an Adobe After Effects comp and build animation as ordinary editable layers and keyframes.
README in short
A Lightroom plug-in creates a local token and the npm server connects to it over SDK sockets. The core tool set does not change develop settings.