Bring Media Management
to Cline
Learn how to connect PhotoPrism to Cline and start using 7 AI agent tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the PhotoPrism MCP Server?
Connect your self-hosted PhotoPrism instance to any AI agent to interact with your personal media collection through natural language.
What you can do
- Advanced Search — Query your library using keywords, colors, or dates with the
search_photostool. - Visual Previews — Generate direct URLs for thumbnails in various sizes using
get_thumbnail_url. - Video Streaming — Access streaming links for your stored videos with
get_video_url. - OAuth Management — Handle authentication tokens and user information securely with
create_oauth_tokenandget_oauth_userinfo.
How it works
- Subscribe to this server
- Enter your PhotoPrism URL and API Token
- Start searching and viewing your media from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Photography Enthusiasts — Quickly find specific shots without manual scrolling through thousands of files
- Self-Hosters — Integrate your private cloud with your favorite AI tools for a seamless media experience
- Content Creators — Retrieve assets from your library directly within your coding or writing workflow
Built-in capabilities (7)
Create an OAuth2 token
Get OAuth2 Authorization
Get OAuth2 UserInfo
Get a thumbnail image URL for a photo
Get a video streaming URL
Revoke an OAuth2 token
Search for photos in PhotoPrism
Why Cline?
Cline operates autonomously inside VS Code. it reads your codebase, plans a strategy, and executes multi-step tasks including PhotoPrism tool calls without waiting for prompts between steps. Connect 7 tools through Vinkius and Cline can fetch data, generate code, and commit changes in a single autonomous run.
- —
Cline operates autonomously. it reads your codebase, plans a strategy, and executes multi-step tasks including MCP tool calls without step-by-step prompts
- —
Runs inside VS Code, so you get MCP tool access alongside your existing extensions, terminal, and version control in a single window
- —
Cline can create, edit, and delete files based on MCP tool responses, enabling end-to-end automation from data retrieval to code generation
- —
Transparent execution: every tool call and file change is shown in Cline's activity log for full visibility and approval before committing
PhotoPrism in Cline
PhotoPrism and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect PhotoPrism to Cline through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for PhotoPrism in Cline
The PhotoPrism MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 7 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Cline only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
PhotoPrism for Cline
Every tool call from Cline to the PhotoPrism MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
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.
How does Cline connect to MCP servers?
Cline reads MCP server configurations from its settings panel in VS Code. Add the server URL and Cline discovers all available tools on initialization.
Can Cline run MCP tools without approval?
By default, Cline asks for confirmation before executing tool calls. You can configure auto-approval rules for trusted servers in the settings.
Does Cline support multiple MCP servers at once?
Yes. Configure as many servers as needed. Cline can use tools from different servers within the same autonomous task execution.
Server shows error in sidebar
Click the server name to see logs. Verify the URL and token are correct.
Explore More MCP Servers
View all →
Hiro.fm
10 toolsCreate and distribute audio content with a podcast-like platform that lets you build a private audio feed for your audience.
Automate Reddit interactions via AI — search subreddits, list hot posts, and retrieve comment threads directly.
Plausible
10 toolsMonitor website analytics via Plausible — track visitors, pageviews, and bounce rates directly from any AI agent.
Cohere (Embed & Rerank)
6 toolsEmpower RAG via Cohere — generate high-quality text embeddings, rerank documents for better accuracy, and perform AI classification directly from any AI agent.