Pixabay MCP Server
Provides access to Pixabay's API for searching and retrieving royalty-free images and videos, with advanced filtering options for category, orientation, color, size, and quality.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Pixabay MCP Server search for sunset photos with horizontal orientation and warm colors"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Pixabay MCP Server
A Model Context Protocol (MCP) server that provides access to the Pixabay API for searching and retrieving royalty-free images and videos.
📖 Complete Setup and Usage Guide - Step-by-step tutorial with examples and troubleshooting
Features
Image Search: Search through millions of royalty-free images
Video Search: Find high-quality stock videos
Advanced Filtering: Filter by category, orientation, color, size, and more
Individual Lookup: Get specific images or videos by ID
Multiple Formats: Access different image sizes and video qualities
Related MCP server: Pixabay MCP Server
Installation
Clone this repository:
git clone <your-repo-url>
cd pixabay-mcp-serverInstall dependencies:
npm installBuild the project:
npm run buildConfiguration
API Key Setup
You'll need a Pixabay API key to use this server:
Sign up at Pixabay
Go to Pixabay API page
Get your API key
Set the system environment variable (recommended for security):
For bash/zsh (add to ~/.bashrc, ~/.zshrc, or ~/.bash_profile):
export PIXABAY_API_KEY="your-api-key-here"For fish (add to ~/.config/fish/config.fish):
set -gx PIXABAY_API_KEY "your-api-key-here"For Windows (Command Prompt):
setx PIXABAY_API_KEY "your-api-key-here"After setting the environment variable, restart your terminal or run:
source ~/.zshrc # or your shell's config fileClaude Desktop Configuration
Add the server to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Recommended (using system environment variable):
{
"mcpServers": {
"pixabay": {
"command": "node",
"args": ["/path/to/pixabay-mcp-server/dist/index.js"]
}
}
}Alternative (less secure - API key in config file):
{
"mcpServers": {
"pixabay": {
"command": "node",
"args": ["/path/to/pixabay-mcp-server/dist/index.js"],
"env": {
"PIXABAY_API_KEY": "your-api-key-here"
}
}
}
}Security Note: The recommended approach uses your system environment variable, keeping the API key out of configuration files.
Available Tools
search_images
Search for royalty-free images with various filters:
q: Search term (max 100 characters)lang: Language code (default: "en")image_type: "all", "photo", "illustration", "vector"orientation: "all", "horizontal", "vertical"category: Category filter (nature, business, etc.)min_width/min_height: Minimum dimensionscolors: Color filter (red, blue, grayscale, etc.)editors_choice: Editor's Choice awards onlysafesearch: Safe for all agesorder: "popular" or "latest"page: Page number (default: 1)per_page: Results per page (3-200, default: 20)
search_videos
Search for royalty-free videos with similar filtering options:
q: Search termvideo_type: "all", "film", "animation"All other parameters similar to image search
get_image_by_id
Retrieve a specific image by its Pixabay ID:
id: Pixabay image ID (required)
get_video_by_id
Retrieve a specific video by its Pixabay ID:
id: Pixabay video ID (required)
Usage Examples
Basic Image Search
Search for "mountain landscape" photosAdvanced Image Search
Search for horizontal nature photos with minimum width 1920px, editors choice onlyVideo Search
Find animation videos about "space exploration"API Rate Limits
100 requests per 60 seconds by default
Responses must be cached for 24 hours
Systematic mass downloads are not allowed
Response Format
The server returns JSON responses with image/video metadata including:
URLs for different sizes
Dimensions and file sizes
View/download/like counts
User information
Tags and categories
Development
Running in Development Mode
npm run devBuilding
npm run buildTesting
npm testContributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
Author
Created by UnlockMCP - Your guide to mastering Model Context Protocol implementations.
License
MIT License - see LICENSE file for details
Disclaimer
This server provides access to Pixabay's API. Please comply with:
Pixabay's Terms of Service
Content License requirements
Attribution requirements when displaying search results
Rate limiting and caching requirements
Images and videos are subject to Pixabay's Content License. Always check individual image/video licenses before use.
Available Tools
4 toolsget_image_by_idB
Retrieve a specific image by its Pixabay ID
Inputs: id (required).
get_video_by_idB
Retrieve a specific video by its Pixabay ID
Inputs: id (required).
search_imagesC
Search for royalty-free images on Pixabay
Inputs: q, lang, image_type, orientation, +9 more.
search_videosC
Search for royalty-free videos on Pixabay
Inputs: q, lang, video_type, category, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose with no ambiguity: two tools retrieve specific media by ID (image vs. video), and two tools search for media (images vs. videos). The resource type (image/video) and action (get/search) are consistently differentiated, making misselection unlikely.
Tool names follow a perfect verb_noun pattern throughout: all use snake_case with consistent verbs ('get' for retrieval, 'search' for searching) and clear nouns ('image_by_id', 'video_by_id', 'images', 'videos'). There are no deviations or mixed conventions.
With 4 tools, this server is well-scoped for its Pixabay media retrieval purpose. Each tool earns its place by covering essential operations: retrieval and search for both images and videos, which is appropriate and not overly complex or thin.
The tool surface is complete for the domain of accessing Pixabay media. It provides full coverage for both images and videos with retrieval (get) and discovery (search) operations, leaving no obvious gaps or dead ends for an agent working with this API.
Maintenance
Related MCP Connectors
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
Search CC0 photos and build placeholder image URLs at exact sizes with Lorem Picsum.
1Search attributed image prompts, retrieve full templates, and browse GPT Image Hub categories.
Upload, generate, organize, search, and transform images, videos, and files with AI-powered tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables searching and retrieving high-quality stock photos from Pexels with advanced filtering options including orientation, size, color, and localization support.33 npmISC
- AlicenseBqualityDmaintenanceEnables AI assistants to search for and retrieve images, illustrations, and videos directly from Pixabay. It provides specialized tools for discovering diverse media content like photos and animations using the Pixabay API.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and retrieving free photos and videos from Pexels using natural language queries, with support for filters like orientation, size, color, and duration.33 npmISC
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search and retrieve Pexels photos, videos, and collections, including curated and popular media, with filtering by orientation, size, color, locale, and duration. Also supports fetching individual photos, videos, and collection media through the Pexels API.92 npmMIT