Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use PhotoPrism with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Search, browse, and manage your PhotoPrism media library. find photos by metadata, retrieve thumbnails, and stream videos via AI.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 7 capabilities

The complete PhotoPrism capability set.

These are the exact actions your AI can choose when you ask it to work with PhotoPrism.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 7 available through PhotoPrism.

  1. 01

    Create oauth token

    Create an OAuth2 token

  2. 02

    Get oauth userinfo

    Get OAuth2 UserInfo

  3. 03

    Get thumbnail URL

    Get a thumbnail image URL for a photo

  4. 04

    Get video URL

    Get a video streaming URL

Capability set02 / 02

05-07

3 capabilities in this set.

Part of 7 available through PhotoPrism.

  1. 05

    Get oauth authorize

    Get OAuth2 Authorization

  2. 06

    Revoke oauth token

    Revoke an OAuth2 token

  3. 07

    Search photos

    Search for photos in PhotoPrism

Observed, not estimated

856ms average. Fast in production.

PhotoPrism is checked daily against the live service.

Daily averagePeak 1092ms
Aug 20Today
Fastest day
734ms
Slowest day
1092ms
14-day trend
Stable+4%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 7 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of PhotoPrism, so you can see the experience inside your AI.

It does not authenticate your account with PhotoPrism. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

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"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions PhotoPrism owners ask.

  • 01

    Can I search for photos by specific filters like color or camera model?

    Yes! Use the search_photos capability with the q parameter. You can use filters like 'color:blue' or 'camera:iPhone' just as you would in the PhotoPrism web interface.

  • 02

    What thumbnail sizes are available for my photos?

    The get_thumbnail_url capability supports several standard sizes: tile_50, tile_500, fit_720, fit_1280, and fit_1920.

  • 03

    Does this integration support video playback?

    Yes. The get_video_url capability constructs a streaming URL for a specific file hash, allowing you to view your videos directly from the provided link.

Explore

More in Productivity

Suggestions