About Photos Macos MCP
Photos Macos MCP is an MCP server in the Search category: read-only Model Context Protocol (MCP) server in Swift for browsing, searching, and retrieving metadata/images from macOS Photos.
Install
git clone https://github.com/maximbilan/photos-macos-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (12)
get_album_contentsAssets in an album by identifier
Parameters not published.
get_asset_classificationsVision classification labels and confidence scores for a photo
Parameters not published.
get_asset_detailsFull metadata for an asset
Parameters not published.
get_library_statsTotal photos, videos, albums, and date range
Parameters not published.
get_photo_fullFull-resolution image as base64 JPEG
Parameters not published.
get_photo_thumbnailBase64 JPEG thumbnail
Parameters not published.
get_photos_by_datePhotos on a date or in a range
Parameters not published.
get_photos_by_locationPhotos within a radius of lat/long
Parameters not published.
get_photos_by_placePhotos by place name (e.g. Valencia, Paris)—geocodes and searches
Parameters not published.
list_albumsList all user and smart albums (name, id, asset count, type)
Parameters not published.
list_momentsMoments/collections (iOS only on macOS)
Parameters not published.
search_photosSearch by date range, media type, favorites, keyword
Parameters not published.
Ask AI
Ask AI about Photos Macos MCP
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.