Agent tools · TypeScript / Bun / MCP
Stillport
Your photos, within reach.
Stillport gives AI agents a CLI and an MCP server for Apple Photos, Google Photos Picker and local Google Takeout archives. Search natively, inspect metadata, and export only what the agent needs to see.
- Free
- Open source
- macOS
- Windows
- Linux
- MCP
Why I built it
An agent that can see your photos can help with a lot: finding the receipt from that trip, the whiteboard from class, the picture you meant to send. But giving it that access should never mean handing over the whole library or a password. Stillport is the careful version: native search, only the items you need, nothing edited or deleted.
Three sources, one tool
On a Mac, Stillport asks Apple Photos to run its own search and exports a rendered copy or the original. For Google Photos it uses the supported Picker: you search and choose in Google's own interface, and the agent can retrieve only what you picked. For a Google Takeout archive, it builds a private local index of filenames, captions, dates and folders and leaves the archive where it is.
Built for agents
Every command returns JSON by default, including errors, with stable exit codes and paged results. The MCP server exposes search, metadata, previews, exports and offline galleries, but not credential management or self-update. There is no hosted middleman, no telemetry and no AI API key.
Find the right photo without handing over the library
- Search Apple Photos with its own native search engine, including people, places and text where Photos supports them.
- Let a person pick from Google Photos through Google's Picker, then retrieve only those items.
- Index an extracted Google Takeout archive locally without copying it.
- JSON output, bounded pages, clear exit codes and an MCP server, built for agents.
- Standalone binaries with checksum-verified install and update on macOS, Windows and Linux.
Limits. Read-only by design - no editing or deletion. Google's Picker requires a person to choose the photos, and the macOS binaries are not notarized.
Get Stillport
curl -fsSL https://raw.githubusercontent.com/baney75/stillport/main/install.sh | shFull setup, configuration and troubleshooting are in the Stillport documentation.
Found a bug or want something added? Report a bug or request a feature on GitHub. No GitHub account? Email me.
Stillport questions
What is Stillport?
Stillport gives AI agents a CLI and an MCP server for Apple Photos, Google Photos Picker and local Google Takeout archives. Search natively, inspect metadata, and export only what the agent needs to see.
Is Stillport free?
Yes. Stillport costs nothing, and its source code is on GitHub under the MIT license.
How do I install Stillport?
On macOS or Linux, run the install script. It verifies the release's SHA-256 checksum and puts stillport in ~/.local/bin. On Windows, a PowerShell installer picks x64 or ARM64 and needs no administrator rights.
What does Stillport run on?
macOS, Windows and Linux. Apple Photos search needs a Mac. Any MCP client can use its MCP server.
Can an agent edit or delete my photos with Stillport?
No. Stillport is read-only by design. Each export goes to a new private folder, and nothing is overwritten or uploaded. There is no telemetry and no hosted middleman.
Does Stillport have limits?
Read-only by design - no editing or deletion. Google's Picker requires a person to choose the photos, and the macOS binaries are not notarized.
Documentation
