PhotoPrism Connector for AI agents.
7 live capabilities
Search and manage your self-hosted photo library with natural language commands.
Waiting for input…
Why people use PhotoPrism
PhotoPrism for managing large personal photo libraries
This Connector changes that by letting you just ask for it. You type a description of what you're looking for, and your agent handles the heavy lifting of querying your metadata, colors, and dates. You get the exact files you need without the manual hunt.
What Vinkius changes
You get a natural language interface for your entire private photo and video archive.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding a specific trip photo
A traveler asks for 'beach photos from July 2022' and gets a list of results instantly using `search_photos`.
- Real-world use case 02
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`.
- Real-world use case 03
Organizing a video archive
A videographer asks for streaming links to all 'drone footage' to check them during a meeting using `get_video_url`.
Complete set · 7capabilities
The complete PhotoPrism capability set.
These are the exact actions your AI can choose when you ask it to work with PhotoPrism.
01—04
4 capabilities in this set.
Part of 7 available through PhotoPrism.
- 01 Capability
Create oauth token
Generate a new OAuth2 token to securely authorize your AI agent's access to your library.
- 02 Capability
Get oauth userinfo
Fetch the profile details of the current user to ensure the agent is acting on the right account.
- 03 Capability
Revoke oauth token
Cancel an existing authorization token to keep your account secure when you no longer need the connection.
- 04 Capability
Search photos
Search your entire library using keywords, dates, or colors to find specific media instantly.
05—07
3 capabilities in this set.
Part of 7 available through PhotoPrism.
- 05 Capability
Get thumbnail url
Get a direct URL for an image thumbnail in various sizes for quick visual previews.
- 06 Capability
Get video url
Retrieve a streaming link for a video file so you can watch it without downloading it first.
- 07 Capability
Get oauth authorize
Obtain the necessary authorization for the initial connection between your agent and PhotoPrism.
Set up in minutes
One URL. Then ask PhotoPrism to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use PhotoPrism from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it PhotoPrism, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable PhotoPrism for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the PhotoPrism URL.
- Step 03
Save and start
Save the connection and enable PhotoPrism in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"photoprism": {
"url": "https://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using PhotoPrism
Open Agent mode in chat and ask: "Using PhotoPrism, help me...". 7 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"photoprism": {
"url": "https://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using PhotoPrism
Ask Copilot: "Using PhotoPrism, help me...". 7 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"photoprism": {
"url": "https://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using PhotoPrism
Open Cascade and ask: "Using PhotoPrism, help me...". 7 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"photoprism": {
"url": "https://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using PhotoPrism
Ask Cline: "Using PhotoPrism, help me...". 7 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add photoprism --transport http "https://edge.vinkius.com/vk_preview_6XVCzNvtOaKpAfEYjRNVEwWnPAxRLxbI26GclsjI/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using PhotoPrism
Ask Claude: "Using PhotoPrism, show me...". 7 tools are ready
Where the request belongs
Work PhotoPrism can move forward.
This is for the privacy-conscious photographer who has a massive local library and hates the manual labor of sorting through thousands of files to find one specific memory.
Photography Enthusiast
Finds specific shots from years ago by asking for 'blue mountains' instead of manual browsing.
Self-Hoster
Connects their private cloud to an AI agent to keep their personal data off third-party clouds.
Content Creator
Pulls visual assets directly into their writing or coding workspace to reference specific project media.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsImmich (Google Photos Alternative)
Manage your self-hosted Immich photo and video library. list assets, organize albums, and handle user administration via AI.
Pics.io
Organize and share creative assets with a digital asset management platform that tags, searches, and delivers files fast.
Flickr
Browse, search, and manage photo collections on Flickr with access to one of the largest creative photography communities online.
Flickr Photo Discovery
Universal photography intelligence. search millions of public photos via AI.
Unsplash
Access millions of high-resolution images. search photos, manage collections, and track download statistics directly from any AI agent.
Getty Images
Manage stock media via Getty Images. search millions of creative and editorial photos, handle video discovery, and download assets directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep PhotoPrism connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about PhotoPrism.
The practical details behind the request, access and result.
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 capability 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 capability 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 capability constructs a streaming URL for a specific file hash, allowing you to view your videos directly from the provided link.
One connection away
Give your agent a direct line to PhotoPrism.
Connect PhotoPrism once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available