Set it up
-
Turn on Freepik in your AI
Run the Freepik MCP server with your Freepik API key, then ask your AI to find an icon or generate an image.
-
Add it to your app once
Copy the short config below into your app. It just tells your AI where to find Freepik.
-
Just ask
Tell it what you want in plain words — no special commands.
For example, say
“Find a flat-style rocket icon and download the SVG, then generate a hero image of a startup launching to space.”
Need the exact config? Show it +
Add to your client
{
"mcpServers": {
"freepik-fastmcp": {
"command": "uv",
"args": [
"run",
"--directory",
"/absolute/path/to/freepik-mcp",
"main.py"
],
"env": {
"FREEPIK_API_KEY": "<your-freepik-api-key>"
}
}
}
}Paste into your client's MCP configuration file.
Ready-to-run prompts
If you ask, Freepik does it. Copy one, paste it into Claude, Codex or ChatGPT, done. No setup.
Freepik Make a retro poster
If you ask
“Generate a retro 80s synthwave poster about a road trip to the mountains.”
Then
An 80s-style poster of your idea.
Freepik Generate an app icon set
If you ask
“Make 5 matching flat-style icons for a fitness app: run, water, sleep, food, heart.”
Then
A set of matching flat icons.
Freepik Create a landing hero image
If you ask
“Generate a wide hero image of a cozy coffee shop at sunrise, with empty space on the left for a headline.”
Then
A clean hero image with room for text.
How to get good results
Checked 2026-06-14 — live · by Ilya GindinTested prompts and honest limits — deeper than the README.
Freepik does two jobs — find a ready-made icon or asset, or generate a new image. Be specific about style, and always ask for the file type you actually need: SVG for icons, PNG or JPG for images.
Find a usable icon fast
Prompt that works
“Find a flat-style rocket icon with a thin outline, and download it as SVG.”
Why: Naming the style ('flat', 'thin outline') and the format (SVG) gets you something drop-in instead of a raster you have to clean up.
Generate a hero image you can lay out
Prompt that works
“Generate a wide hero image: a startup desk at golden hour, soft depth of field, lots of empty space on the right for text.”
Why: Asking for negative space ('empty on the right for text') makes the image usable in a real layout, not just pretty on its own.
Get matching variations
Prompt that works
“Generate 3 variations of that image — same palette and mood, different camera angle.”
Why: Variations on a locked palette and mood give you options that still belong to the same set.
What it can’t do
- ×Needs your Freepik API key; image generation spends credits.
- ×Stock assets carry Freepik's licensing — check terms before commercial use.
- ×Generated images aren't editable vectors; for true vector work use the icon search.
- ×Official connector, but you run it locally (uv) with your key.
What it can access
Search queries and generation prompts go to Freepik’s API with your FREEPIK_API_KEY; found and generated assets download to your machine.
Source: github.com · checked 2026-07-13
When to use
- ✓ You need quick stock icons or images
- ✓ You want to generate images from a prompt
- ✓ You want an official, vendor-backed connector
When not to use
- × You need video generation (this connector focuses on images and icons)
- × You want a fully free tool with no credits
About
Freepik is a huge library of stock images, icons, and AI image tools. Its official connector lets an assistant like Claude search Freepik's library and generate new images (with Freepik's Mystic model) on your behalf — you just describe what you need.
It's an official connector from Freepik. It runs on your machine and calls Freepik's cloud with your API key.
Workflows That Use Freepik
Animate one still in Kling, add a natural voiceover in ElevenLabs, and post a vertical reel — no video editor, no studio voice.
Polish the shot in Freepik, give it motion in Kling, add a friend-like voice in ElevenLabs, caption it in Descript — a TikTok-ready ad from a single photo.
Ask Freepik for a fresh image from a description, or pull a ready-made icon — straight from your chat.
FAQ
What does Freepik do? +
Freepik is a huge library of stock images, icons, and AI image tools. Its official connector lets an assistant like Claude search Freepik's library and generate new images (with Freepik's Mystic model) on your behalf — you just describe what you need.
Do I need to know how to code? +
No. Turn it on in your AI's settings and ask in plain English — no terminal, no coding.
When should I use Freepik? +
Reach for it when you need to: You need quick stock icons or images; You want to generate images from a prompt; You want an official, vendor-backed connector.
When should I avoid Freepik? +
Skip it when: You need video generation (this connector focuses on images and icons); You want a fully free tool with no credits.
Is Freepik free? +
Freepik has a free tier.
How do I install Freepik? +
In Claude Code, run: claude mcp add freepik-fastmcp -e FREEPIK_API_KEY=<your-freepik-api-key> -- uv run --directory /absolute/path/to/freepik-mcp main.py. Copy-paste configs for Claude Desktop, Cursor, and Windsurf are at the top of this page.
How do I find a usable icon fast with Freepik? +
Try this prompt: "Find a flat-style rocket icon with a thin outline, and download it as SVG." — Naming the style ('flat', 'thin outline') and the format (SVG) gets you something drop-in instead of a raster you have to clean up.
How do I generate a hero image you can lay out with Freepik? +
Try this prompt: "Generate a wide hero image: a startup desk at golden hour, soft depth of field, lots of empty space on the right for text." — Asking for negative space ('empty on the right for text') makes the image usable in a real layout, not just pretty on its own.
How do I get matching variations with Freepik? +
Try this prompt: "Generate 3 variations of that image — same palette and mood, different camera angle." — Variations on a locked palette and mood give you options that still belong to the same set.
