apple-photos-mcp

MCP server for Apple Photos — list albums, search, export, and manage photos via AppleScript.

Install

npm install
npm run build

Usage

npm start

Tools

| Tool | Description | |------|-------------| | photos_list_albums | List all albums with photo counts | | photos_recent | Get N most recent photos | | photos_search | Search photos by text (ML-based) | | photos_get_info | Get metadata: date, location, dimensions, keywords | | photos_export | Export a photo to a directory | | photos_create_album | Create a new album | | photos_favorites | List favorited photos |

MCP Config

{
  "apple-photos": {
    "command": "node",
    "args": ["/Volumes/Virtual Server/projects/apple-photos-mcp/dist/index.js"]
  }
}