unsplash-mcp-server

MCP.Pizza Chef: hellokaton

Ask for a picture in plain words and your assistant comes back with matching photos from Unsplash, each with its description, exact pixel size, and a link in several sizes. You can narrow results to eleven colours, to landscape, portrait or square, and to newest or most relevant. It only finds photos — it never downloads, saves, edits, or uploads them, and it will not tell you the photographer's name. You need a free Unsplash developer key, and that free tier limits how many searches you can run per hour.

Images/Design

Web/Research

Use This MCP server To

Find a free landscape photo for my blog header Search photos by colour to match my slide deck Pull ten vertical shots of coffee shops for a mood board Check a photo's pixel size before dropping it into a design Grab image links to paste straight into a draft

README

Unsplash MCP Server

English | 简体中文

A simple MCP server for seamless Unsplash image integration and search capabilities.

📋 Overview

Unsplash MCP Server is used for searching rich, high-quality images. It's ideal for developers who want to integrate Unsplash functionality into their own applications.

✨ Features

Advanced Image Search: Search Unsplash's extensive photo library with filters for:
- Keyword relevance
- Color schemes
- Orientation options
- Custom sorting and pagination

🔑 Obtaining Unsplash Access Key

Before installing this server, you'll need to obtain an Unsplash API Access Key:

Create a developer account at Unsplash
Register a new application
Get your Access Key from the application details page
Use this key in the configuration steps below

For more details, refer to the official Unsplash API documentation.

unsplash-mcp-server FAQ

Do I need an Unsplash account?

Yes. Sign up as a developer on Unsplash, register an app, and paste the access key it gives you into the setup once.

Can I use this to download photos onto my computer?

No. It hands back web links to each photo, and you save the ones you want yourself.

Which apps does it work in?

The instructions cover Claude Desktop, Cursor, Cline, and Windsurf, and it will work in any app that lets you add MCP servers.

Does it cost money?

No. Unsplash photos are free to use, though the free developer key caps how many searches you can run in an hour.

Can I ask for a specific colour or shape?

Yes. You can filter by eleven colours and by landscape, portrait, or square, and sort by newest or most relevant.

Does it tell me who took the photo?

No. Results include only the description, the dimensions, and the image links, so open the photo on Unsplash if you need to credit the photographer.

How much does it actually add?

One tool, photo search. There is no uploading, no collections, and no image editing.