freepik

This MCP server enables seamless integration with Freepik's APIs, allowing AI assistants such as Claude or Cursor to search, generate, and manage visual content directly within your workflow. The server exposes capabilities like icon search and download, multimedia resource management, AI-based image classification, and image generation using Mystic AI. By running the server with uv, you can route requests from your AI tools to Freepik and receive structured results that you can present or process further in your assistant prompts.

To use the tools, configure the MCP server in your assistant’s context or config file (as shown in the example). The available features typically include: icon search and download in multiple formats, resource management for multimedia assets, AI-driven image classification to tag and categorize visuals, and image generation for creating custom visuals. Ensure you supply your Freepik API key via the environment variable FREEPIK_API_KEY so the server can authenticate with Freepik on requests.

Prerequisites:

• Python 3.12+ installed
• uv dependency manager
• Freepik API Key (get from freepik.com/api)

Installation steps:

1. Clone and navigate to the project directory:

git clone <REPOSITORY_URL>
cd freepik-mcp

2. Install using Makefile:

# Install dependencies
make install

# Verify installation
make version

3. Configure your API Key:

echo "FREEPIK_API_KEY=your_api_key_here" > .env

Get your API Key at: https://freepik.com/api

Tips and considerations:

• Ensure you have Python 3.12+ installed and uv properly set up before starting the MCP server.
• Store sensitive keys in environment variables (e.g., FREEPIK_API_KEY) and avoid committed keys.
• The configuration example uses Windows compatibility note: Windows users should run under WSL for this MCP setup.
• When customizing the mcpServers section, use the full path to your freepik-mcp directory in the --directory argument.
• If you encounter "Command not found" errors, verify that uv is installed and accessible in your PATH.
• If your API key becomes invalid, regenerate it on freepik.com/api and update the env var.
• Use make dev for development mode with auto-reload, or make run for production mode.