Skip to main content
Glama

Unsplash MCP Server

English | 简体中文

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

Python 3.9+ License: MIT

Trust Score Listed on Skillselion

📋 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.

Related MCP server: Unsplash MCP Server

✨ 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:

  1. Create a developer account at Unsplash

  2. Register a new application

  3. Get your Access Key from the application details page

  4. Use this key in the configuration steps below

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

🚀 Installation

To install Unsplash Image Integration Server for Claude Desktop automatically via Smithery:

IDE Setup

Cursor IDE

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

Windsurf

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --key 7558c683-****-****

Cline

npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --key 7558c683-****-****

Manual Installation

# Clone the repository
git clone https://github.com/hellokaton/unsplash-mcp-server.git

# Navigate to project directory
cd unsplash-mcp-server

# Create virtual environment
uv venv

# Install dependencies
uv pip install .

Cursor Editor Integration

Add the following configuration to your Cursor editor's settings.json:

⚠️ Note: Please adjust the following configuration according to your actual installation:

  • If uv is not in your system PATH, use an absolute path (e.g., /path/to/uv)

  • ./server.py should be modified to the actual location of your server script (can use absolute path or path relative to workspace)

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

Using in Cursor

🛠️ Available Tools

Search Photos

{
  "tool": "search_photos",
  "query": "mountain",
  "per_page": 5,
  "orientation": "landscape"
}

🔄 Other Implementations

📄 License

MIT License

📬 Contact

Available Tools

1 tool
search_photosA
Search for Unsplash photos

Args:
    query: Search keyword
    page: Page number (1-based)
    per_page: Results per page (1-30)
    order_by: Sort method (relevant or latest)
    color: Color filter (black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue)
    orientation: Orientation filter (landscape, portrait, squarish)

Returns:
    List[UnsplashPhoto]: List of search results containing photo objects with the following properties:
        - id: Unique identifier for the photo
        - description: Optional text description of the photo
        - urls: Dictionary of available image URLs in different sizes
        - width: Original image width in pixels
        - height: Original image height in pixels

Inputs: query (required), page, per_page, order_by, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'search_photos' has a clearly defined and distinct purpose.

    Naming Consistency5/5

    The single tool follows a clear verb_noun pattern ('search_photos'), and with only one tool, there is perfect consistency by definition.

    Tool Count2/5

    A single tool for an Unsplash server feels thin and incomplete for the domain. While search is a core function, typical photo services would include additional operations like getting photo details, downloading, or user-related actions.

    Completeness2/5

    The tool surface is severely incomplete for an Unsplash server. There are significant gaps: no ability to get photo details by ID, download photos, access user profiles, collections, or statistics. The server only supports search, which limits agent workflows.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables users to search for high-quality photos on Unsplash with support for advanced filtering by orientation and content safety. It provides formatted photo metadata and images in either base64-encoded format or as JSON with URLs via stdio transport.
      1
      44 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching and downloading photos from Unsplash via the Unsplash API, with support for pagination, orientation filtering, and multiple resolutions.
      46 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for searching and retrieving photos from Unsplash with proper attribution, designed for LLMs building content pages.
      3
      38
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that enables searching and downloading Unsplash photos and collections.
      4
      MIT