home / mcp / pixabay mcp server

Pixabay MCP Server

Provides Pixabay media search capabilities for images and videos via an MCP server.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hellohupc-pixabay_mcp": {
      "command": "uvx",
      "args": [
        "https://github.com/helloHupc/pixabay_mcp.git"
      ],
      "env": {
        "PIXABAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Pixabay MCP Server lets your AI assistants search for images and videos on Pixabay. It exposes two actions for your assistant: searching images and searching videos, helping you fetch media quickly and contextually for visual responses.

How to use

Use this server from your MCP client to search for media on Pixabay. You can perform image searches to find photos, illustrations, and vectors, or video searches to find clips and animations. After you configure the server in your MCP client, simply ask your AI helper to search with natural language prompts like “Find yellow flowers” or “Show nature videos.” The MCP client will route requests to Pixabay through the server and return results to your assistant.

Once you have configured the server, restart your MCP client and start issuing search prompts to your assistant. Each request will be translated into a Pixabay query by the MCP server, returning matching media items that you can present to users.

How to install

Prerequisites: ensure you have Python installed and a supported MCP client that can load MCP servers via stdio configurations. You will also need a Pixabay API key to access Pixabay resources.

Method 1: Quick Start with uvx (Recommended)
1. Get your Pixabay API Key
2. Add the following to your MCP client configuration:

{
  "mcpServers": {
    "pixabay": {
      "command": "uvx",
      "args": [
        "https://github.com/helloHupc/pixabay_mcp.git"
      ],
      "env": {
        "PIXABAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Restart your MCP client and start using!

Method 2: Local Development For development or to customize the code, clone the repository locally and configure your MCP client to run the server directly from the local directory:

git clone https://github.com/helloHupc/pixabay_mcp.git
cd pixabay_mcp
```

Then configure your MCP client:

{
  "mcpServers": {
    "pixabay": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/path/to/pixabay_mcp",
        "python", "src/pixabay_mcp/server.py"
      ],
      "env": {
        "PIXABAY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Make sure to replace /path/to/pixabay_mcp with your actual local path.

Additional notes and examples

Get Your API Key: Create a free Pixabay account, navigate to the API documentation, and copy your API key. Then use the key to authorize your searches.

Usage examples you can try once configured include asking your AI assistant to search for imagery like “Search for photos of yellow flowers” or videos like “Find some nature videos.” You can also request vector illustrations, such as “Search vector illustrations of cats.”

Pixabay MCP Server

How to use

How to install

Additional notes and examples

Available tools

search_images

search_videos