• SEARCH
  • VISUAL
  • FILTER
  • HUMAN

How to search your photo library with your AI

Connect PhotoPrism to your AI client to turn your photo library into a searchable database. Once connected, you can find images using plain English descriptions.

Ask AI about this page

Short answer

Can I search my PhotoPrism photos with AI?

Yes. You can describe what you're looking for in natural language, and your AI will scan your PhotoPrism metadata and color attributes to find a match. You'll get a list of images that fit your description.

The results you get

Where your search leads

The AI acts as a bridge between your descriptions and your PhotoPrism database.

SEARCH

Find specific images

The AI scans your library for matches based on your text. You get a list of photos that fit your description.

VISUAL

See photo previews

The AI pulls thumbnail links for the results. You can see exactly which images matched your request.

FILTER

Narrow by color

You can ask for photos with specific color profiles. The AI uses color attributes to filter the results.

HUMAN

Manual curation

The AI finds the files, but you decide which ones to move, delete, or organize in the PhotoPrism interface.

The workflow

What your AI does when you ask for a photo.

Your AI translates your request into specific database queries.

  1. Interpret your request

    Your AI analyzes your natural language to understand the subject, color, or metadata you are looking for.

    search_photos

  2. Query the library

    The AI searches your PhotoPrism instance for images that match your description.

    search_photos

  3. Fetch previews

    Once matches are found, the AI retrieves the necessary links to show you the images.

    get_thumbnail_url

  4. Present results

    The AI shows you the matching images and their details so you can verify the find.

    get_thumbnail_url

Try it

Copy these to start.

Use these prompts to test the connection to your PhotoPrism library.

Starting points

Replace the bracketed text with your own specific descriptions or colors.

PhotoPrism Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — PhotoPrism capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "photoprism-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp"
    }
  }
}
Copy into chat04

  • Find photos in my library that have a lot of blue in them.

  • Search for images of mountains from my summer trip.

  • Show me photos that contain a red car.

  • Find pictures of dogs in my PhotoPrism instance.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect PhotoPrism once, then ask.

Enter your PhotoPrism credentials once to establish the connection. Your login data stays encrypted, and you can immediately start asking questions about your photos.

Connect PhotoPrism to your AI

FAQ

How the photo search behaves

  • 01

    Can the AI delete photos for me?

    No. The AI can only search and retrieve information. You must manage your files directly in PhotoPrism.

  • 02

    How does it know what is in my photos?

    The AI relies on the metadata and color attributes already stored in your PhotoPrism instance.

  • 03

    Can I use this to organize my albums?

    No. The current tools only allow for searching and viewing thumbnails. It cannot create or move photos into albums.

  • 04

    Does it work with any photo app?

    No. This specific connector is built only for PhotoPrism.

  • 05

    Can the AI see my password?

    No. Your credentials are encrypted and used only to maintain the connection to your instance.

  • More questions about PhotoPrism? See everything the PhotoPrism Connector can do

Connect PhotoPrism to Claude, Cursor, ChatGPT & more