Cloudinary Asset Management MCP (Official)

Add to your client

Copy the config for your MCP client and paste it into its config file.

{
  "mcpServers": {
    "cloudinary-asset-management-mcp-official": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "@cloudinary/asset-management-mcp",
        "--",
        "mcp",
        "start"
      ],
      "env": {
        "CLOUDINARY_API_KEY": "<your-api-key>",
        "CLOUDINARY_API_SECRET": "<your-api-secret>",
        "CLOUDINARY_CLOUD_NAME": "<your-cloud-name>"
      }
    }
  }
}

Before you start

• Node.js 18+ and npm (for the local npx-based install)
• A Cloudinary account
• Cloudinary credentials — cloud name, API key, and API secret — found in the Cloudinary Console under Settings > API Keys / Security (often supplied as a single CLOUDINARY_URL: cloudinary://api_key:api_secret@cloud_name)
• An MCP-capable client such as Claude Desktop or Cursor

About Cloudinary Asset Management MCP (Official)

Tools & capabilities (6)

When to use it

• Use it when you want to upload assets to Cloudinary straight from an AI assistant without writing API code
• Use it when you need to find specific media fast using natural-language search across tags and folders
• Use it when generating correct transformation URLs (resize, crop, format, quality) for a given asset
• Use it when bulk-organizing a media library with folders, tags, and metadata updates
• Use it when you need to bundle assets into an archive or produce download links for delivery

Quick setup

1. 1Grab your cloud name, API key, and API secret from the Cloudinary Console (Settings > API Keys)
2. 2Add the server to your MCP client config using npx (e.g. npx -y --package @cloudinary/asset-management-mcp -- mcp start) with CLOUDINARY_URL in env — or point the client at the remote URL https://asset-management.mcp.cloudinary.com/mcp
3. 3Restart the MCP client to load the server
4. 4Verify by asking the agent to list or search a few assets in your environment
5. 5Then try an upload or a transformation request

Cloudinary Asset Management MCP (Official) FAQ