unsplash-mcp-server

Overview

The Unsplash MCP Server provides seamless integration with Unsplash's extensive photo library through the Model Context Protocol. It enables developers to incorporate rich, high-quality images into their applications with advanced search capabilities including keyword relevance, color schemes, orientation options, and custom sorting. The server is well-maintained with clear documentation and multiple installation methods.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• search_photos

  Search Unsplash's photo library with filters for keyword, color, orientation, and pagination

  Try:Find mountain photos with landscape orientationTry:Search for blue abstract imagesTry:Get 10 sunset photos in portrait orientation

Comparable tools

Installation

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --key YOUR_KEY

git clone https://github.com/hellokaton/unsplash-mcp-server.git
cd unsplash-mcp-server
uv venv
uv pip install .

{
  "mcpServers": {
    "unsplash": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "./server.py"],
      "env": {
        "UNSPLASH_ACCESS_KEY": "YOUR_ACCESS_KEY"
      }
    }
  }
}

FAQ

How do I get an Unsplash Access Key?

Create a developer account at Unsplash, register a new application, and get your Access Key from the application details page.

What tools are available in this MCP server?

The primary tool is 'search_photos' which allows filtering by keywords, color schemes, orientation options, and custom pagination.

Compare unsplash-mcp-server with