This server acts as a Model Context Protocol (MCP) server for Cloudinary, allowing AI assistants to interact with and manage Cloudinary assets through exposed Upload & Admin API methods.
Capabilities include:
Upload assets: Upload files to Cloudinary from URLs, file paths, base64 content, or binary data, with options for folders, public IDs, and tags
Delete assets: Remove assets using asset ID or public ID
Get asset details: Retrieve information about specific assets including tags, context, and metadata
Find assets: Search for assets using query expressions with support for pagination and filtering
Get usage reports: Fetch storage, bandwidth, and resource statistics for your Cloudinary environment
Enables access to Cloudinary Upload & Admin API methods, allowing AI assistants to upload assets to Cloudinary and manage assets in a Cloudinary cloud instance.
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
:
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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
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.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.Last updated -54MIT License
- -securityFlicense-qualityA comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.Last updated -331
- -securityAlicense-qualityA server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.Last updated -010MIT License