How to Install Cloudinary MCP in Windsurf
Official Cloudinary integration — upload, transform, optimise, and deliver media assets via AI
What Cloudinary MCP does
The official Cloudinary MCP server gives AI agents full access to your media management pipeline — upload, transform, optimise, and deliver images and videos through natural language commands. Features: - Upload images and videos from URLs or file paths - Apply transformations: resize, crop, format convert, quality optimise - Generate responsive image URLs for different breakpoints - AI-powered background removal and object detection - Manage asset folders and metadata - Search assets by tags, context, or visual similarity - Generate delivery URLs with on-the-fly transformations - Analyse image content and generate alt text Use cases: - "Upload this product image and generate responsive sizes for web" - "Remove the background from these 20 product photos" - "Convert all PNG files in folder /marketing to WebP at 80% quality" - "What's in this image?" (AI content analysis) Cloudinary serves 2 million developers and 10,000+ companies including Fiverr, TED, and The Guardian.
Installation steps
- 1Copy the config below
- 2Open ~/.codeium/windsurf/mcp_config.json
- 3Paste inside "mcpServers": {}
- 4Restart Windsurf
Configuration
File location: ~/.codeium/windsurf/mcp_config.json
{
"cloudinaryMcp": {
"command": "npx",
"args": [
"-y",
"cloudinary-mcp-server"
],
"env": {
"CLOUDINARY_CLOUD_NAME": "your_cloud",
"CLOUDINARY_API_KEY": "123456789012345",
"CLOUDINARY_API_SECRET": "your_secret"
}
}
}Install in other clients
For maintainers
If you maintain Cloudinary MCP, add this badge to your README to show it's verified on CuratedMCP:
[](https://curatedmcp.com/marketplace/cloudinary-mcp)