# PhotoPrism MCP for AI Agents AI Agent Connect > PhotoPrism MCP connects your self-hosted PhotoPrism instance to your AI agent. It allows you to search your personal photo library using natural language, retrieve high-resolution thumbnails, and get streaming links for your stored videos without leaving your workspace. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/ai-agent-connect - **Tags:** media-management, photo-library, metadata-search, self-hosted, ai-tagging, thumbnails ## Description PhotoPrism MCP connects your self-hosted PhotoPrism instance to any AI agent to interact with your personal media collection through natural language. This connection turns your private archive into an interactive hub where you can find specific memories without digging through folders. Instead of manually sorting through thousands of files, you just tell your agent what you're looking for. It handles the heavy lifting of querying your metadata, colors, and dates to pull up the exact shots you need. You can grab direct links for thumbnails to see your media in the chat or get streaming links for videos so you can watch them on the fly. It makes your personal library a functional part of your creative process, whether you're a photographer looking for a specific shot or a creator pulling assets for a new project. Because Vinkius hosts this connection, you can plug it into your existing workflow and start talking to your media collection immediately. It takes the friction out of organizing and retrieving personal assets, making your archives actually useful for your day-to-day work. You no longer have to worry about where a file is stored or what it was named; you just describe the content, and the agent does the rest. ## Tools ### create_oauth_token Generate a new OAuth2 token to securely authorize your AI agent's access to your library. ### get_oauth_userinfo Fetch the profile details of the current user to ensure the agent is acting on the right account. ### revoke_oauth_token Cancel an existing authorization token to keep your account secure when you no longer need the connection. ### search_photos Search your entire library using keywords, dates, or colors to find specific media instantly. ### get_thumbnail_url Get a direct URL for an image thumbnail in various sizes for quick visual previews. ### get_video_url Retrieve a streaming link for a video file so you can watch it without downloading it first. ### get_oauth_authorize Obtain the necessary authorization for the initial connection between your agent and PhotoPrism. ## Prompt Examples **Prompt:** ``` Find some photos of my dog from last summer. ``` **Response:** ``` I found 12 photos of your dog from the summer of 2023. Here are the top 3 results with their thumbnails: | Photo | Thumbnail | Date | | :--- | :--- | :--- | | Dog in grass | [Link] | 2023-07-12 | | Dog at beach | [Link] | 2023-08-05 | | Dog in park | [Link] | 2023-09-10 | ``` **Prompt:** ``` Can you give me a link to watch the drone footage from the mountains? ``` **Response:** ``` I've found the drone footage from your mountain trip. Here is the streaming link: [Link to Video] ``` **Prompt:** ``` Search for any photos that have a lot of blue in them. ``` **Response:** ``` I found 24 photos with a dominant blue color profile. Here are the most recent ones: - Ocean sunset (2022) - Blue lake (2023) - Winter sky (2021) ``` ## Capabilities ### Find photos by metadata Query your library using keywords, colors, or dates to find specific images instantly. ### Get image thumbnails Retrieve direct URLs for photo thumbnails in various sizes for quick visual previews. ### Stream stored videos Get direct streaming links for your video files so you can watch them without downloading. ### Manage account security Handle OAuth tokens and user information to keep your connection secure. ### Browse media via chat Interact with your entire photo collection using plain English instead of manual navigation. ## Use Cases ### Finding a specific trip photo A traveler asks for 'beach photos from July 2022' and gets a list of results instantly using `search_photos`. ### Creating a mood board A designer asks the agent to pull five high-res thumbnails of 'minimalist architecture' for a project using `get_thumbnail_url`. ### Organizing a video archive A videographer asks for streaming links to all 'drone footage' to check them during a meeting using `get_video_url`. ### Managing account access A user wants to make sure their AI agent only has access to their specific user profile by checking `get_oauth_userinfo`. ## Benefits - Stop scrolling through folders by using `search_photos` to find specific memories by date, color, or keyword. - Get instant visual context with `get_thumbnail_url` which provides direct links to images in your chat. - Stream your videos directly using `get_video_url` instead of having to download large files to your local machine. - Keep your data private by connecting your self-hosted instance rather than uploading everything to a public cloud. - Manage your own permissions and security using `create_oauth_token` and `revoke_oauth_token` to control who sees what. - Access your account details quickly with `get_oauth_userinfo` to verify you are looking at the correct library. ## How It Works The bottom line is you get a natural language interface for your entire private photo and video archive. 1. Enter your PhotoPrism URL and API Token into your client settings. 2. Ask your AI agent to find photos or videos using natural language. 3. Receive direct links to thumbnails, streaming content, or search results. ## Frequently Asked Questions **How does the PhotoPrism MCP help with my privacy?** It lets you keep your data on your own hardware. Instead of uploading your personal photos to a public cloud, the agent connects directly to your self-hosted instance. **Can I use the PhotoPrism MCP to find specific dates?** Yes, you can ask your agent to find photos from a specific year, month, or day, and it will query your library metadata to find them. **Does the PhotoPrism MCP support video?** Yes, it can provide streaming links for your stored videos so you can watch them directly without needing to download the files first. **Is it hard to connect my PhotoPrism instance?** It is very straightforward. You just need to provide your PhotoPrism URL and an API token in your AI client settings to get started. **Can I see thumbnails in my AI chat?** Yes, the Connector can provide direct URLs for thumbnails, which your AI client can then display so you can see the images while you chat. **How do I secure my PhotoPrism MCP connection?** You can manage your security by creating and revoking OAuth tokens, ensuring that your AI agent only has access when you want it to. **Can I search for photos by specific filters like color or camera model?** Yes! Use the `search_photos` tool with the `q` parameter. You can use filters like 'color:blue' or 'camera:iPhone' just as you would in the PhotoPrism web interface. **What thumbnail sizes are available for my photos?** The `get_thumbnail_url` tool supports several standard sizes: `tile_50`, `tile_500`, `fit_720`, `fit_1280`, and `fit_1920`. **Does this integration support video playback?** Yes. The `get_video_url` tool constructs a streaming URL for a specific file hash, allowing you to view your videos directly from the provided link.