iphoto
Read-only access to a local library of photos downloaded from iCloud Photos, providing tools to browse library info, search photos by date, camera, GPS, place, on-device content labels and OCR text, fetch detailed metadata for individual photos, view photo files, and refresh the local index.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
photos-mcp
Read-only MCP server for iCloud Photos, all local — no Apple ID credentials stored.
Registered as the iphoto connector (iphoto_server.py) in the Claude desktop app and Claude Code.
It serves a folder of photos downloaded with icloudpd, indexed to SQLite (folder_server.py).
Tools: library_info, search_photos, get_photo_details, view_photo, refresh_index.
Setup
./install-connector.sh # set PHOTOS_FOLDER first to use a folder other than ~/Pictures/icloudThe folder index (<folder>/.photos-index.sqlite) holds date, camera, GPS, an offline place name,
and on-device Apple Vision content labels + OCR text.
Related MCP server: semantic-image-search-mcp
Updating the photos
uvx icloudpd --username YOUR_APPLE_ID --directory ~/Pictures/icloud --folder-structure "{:%Y/%m}" --cookie-directory ~/.pyicloud
uv run python folder_index.py ~/Pictures/icloudBoth are incremental. Apple's sign-in session expires after ~2 months; icloudpd will re-prompt for 2FA.
Or ask Claude to call refresh_index after downloading.
Notes
server.py(Mac Photos.app library via osxphotos) is not part of the connector.Desktop config:
~/Library/Application Support/Claude/claude_desktop_config.json(backup at.bak).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search photos and video moments by visual meaning, people, dates, and folders across local libraries, Apple Photos, and OneDrive. Manage collections, groups, favorites, people, and duplicate review. Synced metadata remains searchable while the desktop is offline; local and Apple Photos media access needs the owning device online with remote access enabled. OneDrive media can be accessed directly from the cloud. OAuth or Bearer API keys. Paid Cloud Access required; hosted visual search uses prepaid credits. Text-in-image search is semantic matching, not guaranteed exact OCR. Setup: https://organizewith.ai/en/guides/connect-ai-assistants
Search photos/videos; manage collections, people and duplicates. Requires paid OwAI Cloud Access.
Read and search folders on your own computer with explicit consent. Files are never uploaded.
Read-only MCP server over the JENRIKS daily photoblog: one photo per day since 2006. No auth.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables AI assistants to query and export from the macOS Apple Photos library using natural language, backed by osxphotos.21782 npm48MIT
- AlicenseAqualityCmaintenanceEnables natural language search of local photo archives using AI-powered semantic understanding, with integration into Claude Desktop via the Model Context Protocol.42MIT
- FlicenseNot gradedqualityCmaintenanceEnables users to search and retrieve photos from a self-hosted Immich photo library via natural language, supporting CLIP-based semantic search, metadata filtering, album browsing, and share link creation.-
- AlicenseAqualityBmaintenanceEnables AI agents to search, inspect, organize, and export photos from a local Apple Photos library using natural language, including scene labels, text, faces, places, and albums.1355 npm1MIT