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 name
CLOUDINARY_API_KEY - The API Key for your cloud
CLOUDINARY_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 upload
  - folder: Optional folder path in Cloudinary
  - publicId: Optional public ID for the uploaded asset
  - resourceType: 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 delete
  - assetId: The asset ID of the asset to delete
get-asset
- Description: Get the details of a specific file (asset)
- Parameters:
  - assetId: The Cloudinary asset ID
  - publicId: The public ID of the asset
  - resourceType: Type of asset (image, raw, video)
  - type: Delivery type (upload, private, authenticated, etc.)
  - tags: Whether to include the list of tag names
  - context: Whether to include contextual metadata
  - metadata: 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 pagination
  - tags: Include tags in the response
  - context: 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

Integrations