CommunitySlow· 1mo★ 4.3by hellokaton

Unsplash MCP

Searches Unsplash for high-quality stock photos with filters for orientation, colour, and size.

View repo

Safety & Trust

Delv Safety Grade: C

Score 58/100 · assessed 2026-04-28

Maintainer45

Permissions85

Supply chain35

Transparency60

Incidents100

Unsplash MCP is a straightforward image search tool from a solo developer (hellokaton) with limited GitHub presence. The server itself is low-risk: it makes read-only API calls to Unsplash and returns photo URLs. Permissions are well-scoped to network outbound and reading the Unsplash API key from environment variables. The main safety concern is supply chain: there's no published package, requiring users to clone the repository and run a local pip install, which bypasses standard package registry vetting. The codebase appears simple and the functionality is narrow, but the maintainer has minimal public activity and no established track record. Transparency is adequate with open source code visible on GitHub, though documentation is thin. No known security incidents. Suitable for non-sensitive prototyping work where you control the installation environment, but the manual install process and unknown maintainer warrant caution.

Lethal Trifecta (prompt-injection exposure)

TWO OF THREE

Private dataNo

Reads secrets, credentials, private files

Untrusted inputYes

Ingests web pages, PRs, issues, emails

External commsYes

Can send data outbound

Image alt text is user-supplied. Outbound on download.

Green flags

Read-only API calls with no write or execution capabilities
Narrow, well-defined scope limited to Unsplash image search
Open source code available for inspection on GitHub
No known security incidents or malicious behaviour

Red flags

Solo maintainer with minimal GitHub activity and unknown track record
No package registry distribution, requires clone-and-install from source
Thin documentation and no visible issue tracker activity
Requires API key in environment without key rotation guidance

Permissions requested

Outbound networkRead env

Assessed by Delv Editorial using public metadata. Grades are advisory and update as the ecosystem changes. They do not replace your own review of permissions and code before granting an agent access to sensitive systems.

Install

uv pip install .

Env vars needed: UNSPLASH_ACCESS_KEY

Review

Unsplash MCP does one thing: it searches Unsplash's library and returns high-quality stock photos you can drop straight into your project. You get filters for orientation (portrait, landscape, square), colour, and size, which is enough to narrow down results without drowning in options. I'd reach for this when I'm prototyping a landing page or need a placeholder hero image that doesn't look like a placeholder. The workflow is straightforward: ask Claude to find images matching a theme or mood, apply a colour filter if your design system demands it, and you get back URLs ready to use. It beats opening a browser tab, scrolling through Unsplash manually, and copy-pasting links. The filters are practical but not exhaustive. You can specify orientation and colour, which covers most use cases for developers who just need something that fits the layout. Size filtering helps if you're optimising for mobile or need a specific resolution. It won't replace a dedicated asset management tool, but that's not the point. This is for quick sourcing, not curating a brand library. Quirks: you need an Unsplash API key, which means signing up for a developer account. The free tier is generous (50 requests per hour), but if you're running this in a team context or automating image pulls, you'll hit limits. The server doesn't cache results, so repeated searches for the same query will burn through your quota. Who shouldn't bother: anyone working in a locked-down corporate environment where API keys are a bureaucratic nightmare, or teams that already have a DAM system. If you're building a production site with strict brand guidelines, you'll want tighter control over assets than a search interface provides. But for solo developers, technical writers, or anyone mocking up interfaces, this is a solid shortcut. It's faster than context-switching to a browser, and the quality is reliably high because it's Unsplash.

Verdict

Install this if you regularly need stock photos and you're already working in Claude Desktop. It's a time-saver for prototyping and content work, not a replacement for proper asset management. Skip it if you rarely touch images or if your workflow already includes a dedicated stock photo tool.

Good at

Filters for orientation and colour are enough to get usable results without faffing about.
Unsplash's library quality is consistently high, so you're not sifting through stock photo clichés.
Faster than switching to a browser when you just need a placeholder or mood board image.
Free tier API quota is generous for solo developers and small projects.

Watch out

Requires an Unsplash developer account and API key, which adds setup friction.
No result caching means repeated searches eat into your hourly request limit.
Limited to Unsplash's library, so if you need niche or brand-specific imagery, you're out of luck.
Not suitable for production asset management or teams with strict brand guidelines.

Use cases

hero image sourcing
blog post illustration
mood board creation
pitch deck assets

Getting started

1. Sign up for an Unsplash developer account at unsplash.com/developers and create an application to get your access key. 2. Clone the repo and run `uv pip install .` in the directory to install dependencies. 3. Add the server to your Claude Desktop config, setting `UNSPLASH_ACCESS_KEY` in the environment variables section. 4. Restart Claude Desktop and test by asking Claude to search for images with a specific colour or orientation. 5. Watch your API quota: the free tier caps at 50 requests per hour, so avoid repeated identical searches.

Works with

Claude DesktopClaude CodeCursor