Set up Cloudinary MCP in Windsurf
Upload, transform, search, and manage images and videos on Cloudinary with asset management, folder operations, and usage metrics.
1
Locate the config file
Windsurf reads MCP server configuration from the following file:
~/.codeium/windsurf/mcp_config.jsonCreate this file if it does not already exist.
2
Add the configuration
Add the following to your Windsurf config file:
json
{
"mcpServers": {
"cloudinary-mcp": {
"command": "npx",
"args": [
"-y",
"@cloudinary/asset-management-mcp"
],
"env": {
"CLOUDINARY_CLOUD_NAME": "YOUR_CLOUDINARY_CLOUD_NAME",
"CLOUDINARY_API_KEY": "YOUR_CLOUDINARY_API_KEY",
"CLOUDINARY_API_SECRET": "YOUR_CLOUDINARY_API_SECRET"
}
}
}
}3
Set up environment variables
Cloudinary MCP requires the following environment variables:
CLOUDINARY_CLOUD_NAMERequiredCloudinary cloud name
CLOUDINARY_API_KEYRequiredCloudinary API key
CLOUDINARY_API_SECRETRequiredCloudinary API secret
4
Verify it works
Restart Windsurf. Cloudinary MCP should appear in your MCP server list with 14 tools available.
This server adds approximately 7,210 tokens to your context window for tool definitions.