• VISUALS
  • VIDEO
  • CONTEXT
  • HUMAN

How to retrieve media assets with your AI

Connect PhotoPrism to your AI client to pull specific visual assets into your active workspace. Once connected, your agent handles the fetching so you can focus on the creative work.

Ask AI about this page

Short answer

How can I get PhotoPrism images and videos into my AI?

Your AI uses specific tools to grab direct URLs for image thumbnails and video streams. You just tell your agent what you need, and it provides the links for your project. This setup gives you immediate access to your PhotoPrism library without leaving your chat.

The results.

Where your assets land.

The AI moves data from your library to your workspace based on your requests.

VISUALS

Image thumbnails

The AI fetches direct links to image previews. You can drop these into documents or design tools immediately.

VIDEO

Streaming links

Your agent pulls video URLs that allow for direct playback. This works for reviewing footage within your current workflow.

CONTEXT

Media metadata

The AI identifies which files match your descriptions. It finds the right assets so you don't have to browse manually.

HUMAN

Manual selection

You decide which specific files are worth pulling. The AI suggests or finds them, but you make the final call on what stays in the project.

The workflow

What your AI does when you ask for media.

The AI acts as a bridge between your PhotoPrism library and your current task.

  1. Identify assets

    Your agent scans your PhotoPrism library to find the specific photos or videos you described in your prompt.

    get_thumbnail_urlget_video_url

  2. Fetch image links

    Once the right image is found, the AI grabs the direct URL for the thumbnail.

    get_thumbnail_url

  3. Fetch video links

    For video files, the AI retrieves a link that allows for streaming the content.

    get_video_url

  4. Deliver to workspace

    The AI provides the final URLs in your chat, ready for you to use in your project.

    get_thumbnail_urlget_video_url

Try it

Copy these to start.

Use these prompts to trigger the PhotoPrism tools.

Starting points

Replace the bracketed text with your actual folder names or file descriptions.

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

  • Get the thumbnail URL for the photo of the sunset in my 'Vacation' folder.

  • Find the video stream link for the footage labeled 'Project Alpha'.

  • Show me the thumbnail for the most recent upload in my landscape collection.

  • I need the video URL for the clip of the dog running.

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

Start here

Connect PhotoPrism once, then ask.

Follow the link to authorize the connection. Your login credentials stay encrypted and secure on our end.

Connect PhotoPrism to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete photos from my PhotoPrism library?

    No. The AI can only retrieve URLs for thumbnails and videos. It cannot modify or delete your files.

  • 02

    Can I download the full-resolution original files?

    No. The available tools only provide URLs for thumbnails and video streams.

  • 03

    Does the AI see my entire library?

    The AI can access the metadata and files within PhotoPrism to find what you ask for, but it only interacts with the specific assets you request.

  • 04

    Can the AI organize my albums?

    No. There are no tools provided to create, move, or rename albums in PhotoPrism.

  • 05

    How do I get the links into my design software?

    The AI provides the URL in the chat. You can then copy that link and paste it directly into your software.

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

Connect PhotoPrism to Claude, Cursor, ChatGPT & more