Pexels MCP Server

An MCP (Model Context Protocol) server that provides access to the Pexels Photos Search API.

Features

Search for photos using text queries
Filter by orientation (landscape, portrait, square)
Filter by size (large, medium, small)
Filter by dominant color
Pagination support
Localization support

Setup

Install dependencies:

npm install

Get a Pexels API key from https://www.pexels.com/api/
Set your API key as an environment variable:

export PEXELS_API_KEY=your_api_key_here

Or create a .env file (copy from .env.example):

cp .env.example .env
# Edit .env with your API key

Build the project:

npm run build

Usage

Running the Server

npm start

Available Tool

`search_photos`

Search for photos on Pexels.

Parameters:

query (required): Search term for finding photos
page (optional): Page number (default: 1)
per_page (optional): Number of results per page (default: 15, max: 80)
orientation (optional): Filter by photo orientation (landscape, portrait, square)
size (optional): Filter by photo size (large, medium, small)
color (optional): Filter by dominant color (red, orange, yellow, green, turquoise, blue, violet, pink, brown, black, gray, white)
locale (optional): The locale for the search (e.g., en-US, pt-BR)

Example Response:

{
  "success": true,
  "data": {
    "total_results": 8000,
    "page": 1,
    "per_page": 15,
    "photos": [
      {
        "id": 415829,
        "width": 2651,
        "height": 3976,
        "url": "https://www.pexels.com/photo/nature-red-love-romantic-415829/",
        "photographer": "Pixabay",
        "photographer_url": "https://www.pexels.com/@pixabay",
        "avg_color": "#C0392B",
        "alt": "Red rose",
        "src": {
          "original": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg",
          "large": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
          "medium": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&h=350",
          "small": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&h=130",
          "tiny": "https://images.pexels.com/photos/415829/pexels-photo-415829.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=200&w=280"
        }
      }
    ],
    "next_page": "https://api.pexels.com/v1/search?query=nature&page=2"
  }
}

Claude Code Configuration

To use this MCP server with Claude Code, add it to your MCP settings:

{
  "mcpServers": {
    "pexels": {
      "command": "node",
      "args": ["/path/to/pexels-mcp-server/dist/index.js"],
      "env": {
        "PEXELS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

Run in development mode:

npm run dev

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables searching and retrieving high-quality stock photos from Pexels with advanced filtering options including orientation, size, color, and localization support.

Related MCP Servers

Rijksmuseum MCP Server
r-huijts
A
security
A
license
A
quality
Allows you to search for artworks, retrieve detailed information about specific artworks, access image tiles for artworks, and explore user-created collections from the Rijksmuseum.
Last updated -
20
56
MIT License
Pixabay MCP Server
zym9863
A
security
A
license
A
quality
A Model Context Protocol server that enables searching for images on Pixabay with query parameters and returns formatted results with image URLs and metadata.
Last updated -
1
3
MIT License
mcp_search_images
yanjunz
-
security
A
license
-
quality
A search service based on multiple image APIs and icon generation capabilities, specifically designed for integration with Cursor MCP service. Supports image search, download, and AI-generated icons.
Last updated -
9
MIT License
Brave Search MCP
mikechao
A
security
A
license
A
quality
Brave Search MCP
Last updated -
5
262
79
GPL 3.0

View all related MCP servers

Pexels MCP Server