Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LIBRARYNoPath to the Photos library to use instead of the system library (--library PATH).
ALLOW_WRITENoEnable commands that change your library: add-locations, batch-edit, import, push-exif, sync, timewarp (--allow-write).false

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Tools for the user's Apple Photos library, built on osxphotos. Use search_photos, get_photo, list_albums, list_people_and_keywords and export_photos first. For anything they cannot do, read osxphotos_help and then call run_osxphotos.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_photosA

Find photos and videos, newest first. All filters are optional and combine with AND.

    text matches title, description, filename, people, keywords, albums, labels and place.
    Dates are ISO (YYYY-MM-DD, optionally with a time) in the photo's local time; to_date
    includes that whole day. album, person and keyword are exact names, ignoring case.
    Returns the total number of matches and up to `limit` (max 100) of them.
    
get_photoB

Full details of one photo: metadata, albums, labels, camera, location and file paths.

list_albumsA

All albums, including shared albums, with their folder and number of photos.

list_people_and_keywordsB

Names of people and keywords in the library with photo counts, most used first.

export_photosA

Copy photos to a folder, using the edited version where one exists.

    Never overwrites existing files. Photos that are not downloaded from iCloud are
    reported as skipped. For more control, use run_osxphotos with the export command.
    
osxphotos_helpA

Help for one osxphotos command, or the list of available commands if none is given.

Pass a topic (one word, for example "location") to see only the options about it.

run_osxphotosA

Run an osxphotos command line command and return its output.

    Pass options as separate items, for example command "query" with args
    ["--no-location", "--json"]. Call osxphotos_help first to see a command's options.
    

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 7 tools

Disambiguation4/5

The native tools target distinct operations: facet listing, search, single-photo detail, album listing and export. The main overlap is `run_osxphotos`, a catch-all CLI escape hatch that duplicates search and export, but its description explicitly frames it as the fallback and even points to itself from `export_photos`, so an agent has clear guidance on which to pick.

Naming Consistency4/5

Most tools follow a clean verb_noun snake_case pattern (list_albums, get_photo, search_photos, export_photos), with sensible singular/plural agreement. The two deviations — `osxphotos_help` (noun_help) and `run_osxphotos` (verb_server) — are minor but break the otherwise predictable scheme.

Tool Count5/5

Seven tools is a well-scoped surface for a photo-library server: one for each core workflow (browse facets, browse albums, search, inspect, export) plus help and a CLI escape hatch. Nothing feels redundant or padded.

Completeness4/5

Read and export coverage is solid: discovery via albums/people/keywords, filtered search, full metadata retrieval and file export. Write-side operations (creating albums, editing keywords/people, deleting or importing photos) have no native tool and rely on `run_osxphotos` plus `osxphotos_help`, which is a workable but less discoverable gap.