Cloudinary MCP Server
A Model Context Protocol server that exposes Cloudinary Upload & Admin API methods as tools by AI assistants. This integration allows AI systems to trigger and interact with your Cloudinary cloud.
How It Works
The MCP server:
- Makes calls on your behalf to the Cloudinary API
- Enables uploading of assets to Cloudinary
- Enables management of assets in your Cloudinary cloud
It relies on the Cloudinary API to perform these actions. Not all methods and parameters are supported. More will be added over time.
Open an issue with a request for specific method if you need it.
Benefits
- Turn your Cloudinary cloud actions into callable tools for AI assistants
- Turn your Cloudinary assets into data for AI assistants
Usage with Claude Desktop
Prerequisites
- NodeJS
- MCP Client (like Claude Desktop App)
- Create & Copy Cloudinary API Key/Secret at: API KEYS
Installation
To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:
{
"mcpServers": {
"cloudinary-mcp-server": {
"command": "npx",
"args": ["-y", "cloudinary-mcp-server"],
"env": {
"CLOUDINARY_CLOUD_NAME": "<cloud name>",
"CLOUDINARY_API_KEY": "<api-key>",
"CLOUDINARY_API_SECRET": "<api-secret>"
}
}
}
}
CLOUDINARY_CLOUD_NAME- your cloud nameCLOUDINARY_API_KEY- The API Key for your cloudCLOUDINARY_API_SECRET- The API Secret for your cloud
Tools
The following tools are available:
-
upload
- Description: Upload a file (asset) to Cloudinary
- Parameters:
source: URL, file path, base64 content, or binary data to uploadfolder: Optional folder path in CloudinarypublicId: Optional public ID for the uploaded assetresourceType: Type of resource to upload (image, video, raw, auto)tags: Comma-separated list of tags to assign to the asset
-
delete-asset
- Description: Delete a file (asset) from Cloudinary
- Parameters:
publicId: The public ID of the asset to deleteassetId: The asset ID of the asset to delete
-
get-asset
- Description: Get the details of a specific file (asset)
- Parameters:
assetId: The Cloudinary asset IDpublicId: The public ID of the assetresourceType: Type of asset (image, raw, video)type: Delivery type (upload, private, authenticated, etc.)tags: Whether to include the list of tag namescontext: Whether to include contextual metadatametadata: Whether to include structured metadata
-
find-assets
- Description: Search for existing files (assets) in Cloudinary with a query expression
- Parameters:
expression: Search expression (e.g. 'tags=cat' or 'public_id:folder/*')resourceType: Resource type (image, video, raw)maxResults: Maximum number of results (1-500)nextCursor: Next cursor for paginationtags: Include tags in the responsecontext: Include context in the response
-
get-usage
- Description: Get a report on the status of your product environment usage, including storage, credits, bandwidth, requests, number of resources, and add-on usage
- Parameters:
date: Optional. The date for the usage report in the format: yyyy-mm-dd. Must be within the last 3 months. Default: the current date