Skip to main content
Glama
nikola-arman

Pexels MCP Server

by nikola-arman
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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

Related MCP server: mcp-server-pexels

Setup

  1. Install dependencies:

npm install

  1. Get a Pexels API key from https://www.pexels.com/api/

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

  1. 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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • Organize with AI (OwAI)A
    ai.organizewith.index

    Search photos and video moments by visual meaning, people, dates, and folders across local libraries, Apple Photos, and OneDrive. Manage collections, groups, favorites, people, and duplicate review. Synced metadata remains searchable while the desktop is offline; local and Apple Photos media access needs the owning device online with remote access enabled. OneDrive media can be accessed directly from the cloud. OAuth or Bearer API keys. Paid Cloud Access required; hosted visual search uses prepaid credits. Text-in-image search is semantic matching, not guaranteed exact OCR. Setup: https://organizewith.ai/en/guides/connect-ai-assistants

    Image & Video ProcessingSearch
    201
  • Pexafy Stock PhotosAOAuth
    com.pexafy

    Find free-to-use stock photos by words, by image or by similarity; every result names its licence.

    SearchImage & Video ProcessingAI & Machine Learning
    52
  • Lightdrift Images MCPAOAuth
    ai.lightdrift

    Search over 1.85 million captioned images using text, a reference image, or both. Upload a JPEG, PNG, or WebP image as base64, or provide a public HTTPS image URL. Find similar images from a Lightdrift asset ID and retrieve hosted file URLs, source licenses, and attribution. Connect with OAuth or an API key. Searches cost $0.005 ($5 per 1,000); image details are free. Setup: https://docs.lightdrift.ai/guides/images-mcp

    AI & Machine LearningDesign ToolsSearch
    1
  • Organize with AIOAuth
    ai.organizewith

    Search photos/videos; manage collections, people and duplicates. Requires paid OwAI Cloud Access.

    Image & Video ProcessingEntertainment & Media
    1

Related MCP Servers