Unsplash MCP Server

@shariqriazz

About Unsplash MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "upsplash-mcp-server": {
      "command": "bun",
      "args": [
        "run",
        "build"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Unsplash MCP Server?

Unsplash MCP Server is a Model Context Protocol (MCP) server that provides tools for interacting with the Unsplash API, allowing users to search for and download photos.

How to use Unsplash MCP Server?

Requires Node.js v18+, Bun, and an Unsplash Access Key. Set up by cloning the repo, installing dependencies with bun install, configuring .env with UNSPLASH_ACCESS_KEY, then building with bun run build. Run standalone with bun run build/index.js. For use with Cline, configure MCP settings with the command and environment variable.

Key features of Unsplash MCP Server?

Provides MCP tools to interact with the Unsplash API
Search for photos based on query, pagination, and orientation
Download photos at specified resolutions (raw, full, regular, small)
Requires Unsplash Access Key configured via environment variable
Downloads photos to a local unsplash/ directory within the workspace
Provides two tools: search_photos and download_photo

Use cases of Unsplash MCP Server?

Search for stock photos by keyword, page, and orientation for content creation
Download high-resolution images directly into project workspaces
Integrate Unsplash photo search and retrieval into AI assistants via MCP
Automate photo sourcing for design or development workflows

FAQ from Unsplash MCP Server

What are the prerequisites for running the server?

Node.js v18+, Bun (npm install -g bun), and an Unsplash account with an API Access Key from unsplash.com/developers.

How do I configure the Unsplash API key?

Create a .env file in the project root with UNSPLASH_ACCESS_KEY="YOUR_KEY" or set the environment variable in your shell or MCP configuration.

Where are downloaded photos saved?

Photos are saved to an unsplash/ directory within the current workspace.

What is the maximum number of items per page when searching?

The per_page parameter has a maximum value of 30.

Do I need an Unsplash API key to use the server?

Yes, a valid Unsplash Access Key configured via the UNSPLASH_ACCESS_KEY environment variable is required.

Frequently asked questions

What are the prerequisites for running the server?

Node.js v18+, Bun (`npm install -g bun`), and an Unsplash account with an API Access Key from unsplash.com/developers.

How do I configure the Unsplash API key?

Create a `.env` file in the project root with `UNSPLASH_ACCESS_KEY="YOUR_KEY"` or set the environment variable in your shell or MCP configuration.

Where are downloaded photos saved?

Photos are saved to an `unsplash/` directory within the current workspace.

What is the maximum number of items per page when searching?

The `per_page` parameter has a maximum value of 30.

Do I need an Unsplash API key to use the server?

Yes, a valid Unsplash Access Key configured via the `UNSPLASH_ACCESS_KEY` environment variable is required.

Comments

Basic information

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

ICSS

chokcoco

不止于 CSS

20.7K

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K