# unsplash-mcp-server

> MCP Server

The Unsplash MCP Server provides seamless integration and search capabilities for Unsplash images, allowing developers to easily incorporate high-quality visuals into their applications with advanced search filters. The Unsplash MCP

## Overview

- **Category:** Developer Tools
- **Language:** Python
- **Stars:** 233
- **Forks:** 10
- **Owner:** hellokaton
- **GitHub:** https://github.com/hellokaton/unsplash-mcp-server
- **Created:** 2025-03-18T08:42:50+00:00
- **Updated:** 2025-03-28T04:37:36+00:00
- **Source:** https://model-context-protocol.com/servers/unsplash-image-search-mcp-server-api

## Setup

## Setup

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

1.  Create a developer account at [Unsplash](https://unsplash.com/developers)
2.  Register a new application
3.  Get your Access Key from the application details page
4.  Use this key in the configuration steps below

To install Unsplash Image Integration Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@hellokaton/unsplash-mcp-server):

### IDE Setup

**Cursor IDE**

```bash
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cursor --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"
```

**Windsurf**

```bash
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client windsurf --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"
```

**Cline**

```bash
npx -y @smithery/cli@latest install @hellokaton/unsplash-mcp-server --client cline --config "{\"unsplashAccessKey\":\"YOUR_ACCESS_KEY\"}"
```

### Manual Installation

```bash
# 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)

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

## Tools

## Available Tools

		1. Advanced Image Search: (Search Unsplash's extensive photo library with filters).
		2. Keyword relevance: (Filter for keyword relevance).
		3. Color schemes: (Filter for color schemes).
		4. Orientation options: (Filter for orientation options).
		5. Custom sorting and pagination: (Filter for custom sorting and pagination).
		6. Search Photos: (Tool to search photos with query, per_page and orientation parameters).