Skip to main content

​
Integrate Freepik into your AI workflows

Connect AI assistants like Claude, Cursor and more with the Freepik API

View on GitHub

​
What is Freepik MCP?

Freepik MCP is a server that implements the Model Context Protocol (MCP) to connect AI assistants with the Freepik API. It enables assistants to search, download, and generate images and icons, manage resources, and use AI-powered image classification tools.

Content Search

Search millions of stock images, icons, and resources directly from your AI assistant.

Content Generation

Generate custom images and icons using our state-of-the-art AI models.

Resource Management

Download and manage your favorite resources directly in your workflow.

AI Classification

Use AI-powered image classification tools to categorize content.

​
Remote Version (Beta)

For an even simpler experience, we offer a remote beta version available at api.freepik.com/mcp that you can use directly with your Freepik API key. No installation required! This version uses the HTTP-stream protocol to communicate with the remote MCP server.

​
Remote Version Benefits

  • No Installation: Immediate access without local setup
  • Always Updated: Automatic access to the latest features
  • Easy Configuration: Only need your API key
  • Zero Maintenance: We handle everything for you
  • HTTP-stream Protocol: Secure communication over HTTPS

​
Configuration for MCP Clients

Add the MCP configuration below to your MCP client configuration file.
  1. Open full Cursor settings
  2. Navigate to the “MCP” tab
  3. Click “Add new global MCP server”
  4. Add the server config below
  5. Click the refresh button next to the “browsermcp” server to reload the server config
For more information, see Cursor’s MCP documentation.
See Claude’s MCP documentation
Claude Desktop currently has a bug where MCP servers are started twice. This will cause Claude to show an error when using the Browser MCP server but it will still work.

​
Server configuration

{
  "mcpServers": {
    "mcp-freepik": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.freepik.com/mcp",
        "--header",
        "x-freepik-api-key:${FREEPIK_API_KEY}"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_api_key_here"
      }
    }
  }
}

​
Open Source Version

The Freepik MCP project is available as open source on GitHub, providing full transparency and customization. This version uses the stdio protocol for local communication between your MCP client and the server.

​
Key Features

  • Open Source: Fully transparent and customizable to your needs
  • Easy Installation: Simple setup with modern tools like uv
  • Native Integration: Compatible with Claude Desktop, Cursor, and other MCP clients
  • Full Functionality: Access to all Freepik API capabilities
  • Stdio Protocol: Direct local communication for maximum performance

​
Installation

# Clone the repository
git clone https://github.com/freepik-company/freepik-mcp.git
cd freepik-mcp

# Install dependencies with uv
uv sync

# Configure your API key
export FREEPIK_API_KEY="your_api_key_here"

​
Configuration for Claude Desktop, Cursor & Other MCP Clients

Add this configuration to your MCP client configuration file: 
{
  "mcpServers": {
    "freepik-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/freepik-mcp",
        "main.py"
      ],
      "env": {
        "FREEPIK_API_KEY": "your_api_key_here"
      }
    }
  }
}

​
Getting Started with MCP

1. Get your API Key

You need a Freepik API key to use either version of MCP.

2. Choose your Version

Decide whether you prefer the open source version (more control) or the remote version (simpler).

3. Configure your Client

Follow the configuration instructions for your preferred AI assistant (Claude, Cursor, etc.).

4. Start Creating!

Once configured, you’ll be able to search, generate, and download content directly from your assistant.

​
Support and Contributions

Documentation

Issues

Contributions

MIT License

Have questions or need help? Don’t hesitate to open an issue on our GitHub repository or contact our support team.
⌘I