LocalLensAgent
Get Pro

Claude Desktop · 100% on-device

The correct way to organize your photos.

Ask in plain English. Every file stays on your machine.

Scroll

Ask once.Sorted.

Person, place and date — one sentence, not an afternoon of folders.

Every tool, one connection.

Every tool. One chat.

Sort, find, de-duplicate and schedule — native calls inside Claude Desktop today, with more MCP clients on the way. Nothing new to learn.

Privacy by architecture

What it does. How to get it.

Find anyone, anywhere

"Find Vidushi's 2025 photos from Lucknow." One request, not three searches.

Set it and forget it

"Watch my camera roll, sort it every Sunday." Change it later in a sentence.

Enroll a family in one go

"Here's Priya's folder, here's Raj's — enroll both." No tagging wizard.

Clean duplicates, on your terms

"Show me what you'd delete above 95% — touch nothing yet." You approve first.

No app to switch to

"Clean up my screenshots folder." Said mid-chat in Claude Desktop — nothing else to open.

Recommended

macOS

Homebrew

brew install ashesbloom/locallens/locallens-agent

Homebrew clears Gatekeeper for you — there is nothing else to run. Launch LocalLens Agent from Applications and look for the LL icon in your menu bar.

Apple Silicon

macOS

Direct DMG

Download the DMGlocallens-agent-v1.1.0-macos-arm64.dmg

Open it and drag LocalLens Agent to Applications.

Sorry about this one — the app is not yet notarized by Apple, so macOS will claim it is damaged or from an unidentified developer. It is neither. Double-click Fix LocalLens Agent.command inside the DMG, or run this once in Terminal:

xattr -cr "/Applications/LocalLens Agent.app" && codesign --force --deep --sign - "/Applications/LocalLens Agent.app"

Prefer Homebrew if you can. It skips this step entirely.

x64

Windows

Installer

Download the installerlocallens-agent-v1.1.0-windows-x86_64-setup.exe

Run it. SmartScreen may warn about an unknown publisher — choose More info, then Run anyway. The tray icon appears in your notification area.

Other builds

x64 runs on Windows on ARM through emulation. The binary-only builds skip the tray app — extract, then run locallens-mcp --setup-claude.

v1.1.0

Source

GitHub

Every build, every checksum, every changelog entry — public since the first tag. The MCP agent is a plain HTTP client that only ever talks to LocalLens on localhost.

Also on GitHub

Business Source License 1.1 — free for personal use, and each release converts to Apache 2.0 four years after it ships.

Automation & Scheduling, on a clock

Runs on its own schedule.

AUTOMATE • SCHEDULE • WATCH • SYNC • AUTOMATE • SCHEDULE • WATCH • SYNC • AUTOMATE • SCHEDULE • WATCH • SYNC •

Real-time watchdog + 24h fallback sweep.

Built in the open

No hidden plumbing.

The MCP agent is a plain HTTP client — it only ever talks to LocalLens's localhost port. Same principle as your data: nothing implicit.

Poke around the source, or debug it live with the MCP Inspector.

Where your data goes

the cloudnever contacted
no route
this machine
Claude Desktop
stdio
LL Agent
no open portBSL 1.1
LocalLens
your photosAGPL-3.0
⏵ locallens·127.0.0.1·0 B out

Three processes, one machine.

LocalLens holds your photos, and it is open source end to end — AGPL-3.0, the whole application. LL Agent is a wrapper around it and nothing more: a plain HTTP client that reads a port file and talks to 127.0.0.1, linking none of the core. What crosses to Claude is text — counts, folder names, and names you chose yourself. Never image data, and never off this machine.

Check our work

the app
Install LocalLens
The agent is a connector — LocalLens is the thing it connects to. Grab a release and run it; the two find each other over localhost.
core · agpl-3.0
Open on GitHub
Every line that touches a photo is public and stays public. AGPL-3.0 means any hosted fork owes you its source too.

Five ways to look at a library

Year, month, day. EXIF first, filename as fallback.

Date.

City and country, reverse-geocoded on your machine.

Location.

By enrolled person. Fast, balanced or accurate.

People.

Name a person, a place and a year — get one folder back.

Find.

Point it at a folder, or pick a day. Sorted as they land.

Automate.

Copies by default · paths checked before anything moves · say stop and it stops

Your library, spinning

Every photo. One grid.

Drag to look around. Indexed on your machine, read from your machine, and it never leaves it.

Get in touch

Questions, licensing, or a collaboration.

One human, one inbox. We reply within two business days.

Where it goes

Media & partnerships

Writing about LocalLens, or exploring a collaboration? Tell us a bit about the piece or the idea and we'll get back to you.

General

Questions, feedback, anything else. Not sure where it fits? Start here — we'll route it internally if it belongs somewhere more specific.

Pro licensing

Used LocalLens during the free preview? You keep Pro free permanently — that is a promise, not a trial. It is normally detected automatically, but if you have reinstalled or switched machines, say so here and we will sort it out. No proof needed.

Bug report

Goes straight to the maintainer's inbox. Include what you were doing, what you expected, and what happened instead — a screenshot helps more than a paragraph.

Media & partnerships

Writing about LocalLens, or exploring a collaboration? Tell us a bit about the piece or the idea and we'll get back to you.

General

Questions, feedback, anything else. Not sure where it fits? Start here — we'll route it internally if it belongs somewhere more specific.

Send a message