location-searchLABSCO SUMMARY
The searches Photos already supports, available to an assistant.
Nothing here uploads anything — it reads the local Photos library after macOS grants permission. The analysis tool is the one that does something the Photos app does not put in front of you: aggregate patterns over time rather than a search result. Names and places are matched loosely, which is the right default when you half-remember what an album was called.
What it is
A server over the macOS Photos library. It answers the questions a folder of images cannot: photos from a place, photos with a person in them, photos under a label, and the patterns across all of them.
What you get
- location-search finds photos taken in a named place and reports how many it found
- label-search finds photos by keyword or label such as Birthday, Beach or Vacation
- people-search finds photos containing a named person
- photo-analysis reports patterns across the library, including the most common times and days you take photos
- Fuzzy matching across those searches, so an approximate name still returns results
Requirements
macOS with a Photos library loaded, plus uv. Clone the repository, run uv sync, and launch with uv run server.py or let the client start it. macOS will ask you to authorise access to your photos the first time it runs; the library is read locally.
Setup effort
Build from source
USE CASES
01
Finding photos from a trip
Search by place name and get the matching files back.
02
Gathering photos of a particular person
Search by name, with fuzzy matching for the ones you are not sure how you spelled.
03
Pulling up an occasion
Labels like Birthday or Vacation are searchable directly.
04
Understanding your own habits
Aggregate patterns over the library — when and how often you shoot.
4 tools
Listed in project docs. Your client may show a different list.
label-searchpeople-searchphoto-analysisBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- uv
- Python 3.11 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"smart-photo-journal": {
"command": "/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv",
"args": [
"--directory",
"/Users/<YOUR_USERNAME>/memory-journal-mcp-server",
"run",
"server.py"
]
}
}
}
