Cloudinary MCP Server provides tools for uploading images and videos to Cloudinary through Claude Desktop and compatible MCP clients, returning media links and details.

Installation

NPX (Recommended)

npx @felores/cloudinary-mcp-server@latest

From Source

git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server
npm install
npm run build

Configuration

Claude Desktop (NPX)

{
  "mcpServers": {
    "cloudinary": {
      "command": "npx",
      "args": ["@felores/cloudinary-mcp-server@latest"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

Claude Desktop (Local)

{
  "mcpServers": {
    "cloudinary": {
      "command": "node",
      "args": ["c:/path/to/cloudinary-mcp-server/dist/index.js"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

Available Tools

Tool	Description
`upload`	Uploads images and videos to Cloudinary with support for file paths, URLs, or base64 data URIs

Features

Upload images and videos to Cloudinary
Support for file paths, URLs, and base64 data URIs
Assign custom public IDs
Ability to overwrite resources
Assign tags to uploaded resources
Specify resource type (image, video, raw)

Environment Variables

Required

CLOUDINARY_CLOUD_NAME - Your Cloudinary cloud name from the Cloudinary console
CLOUDINARY_API_KEY - Your Cloudinary API key from the Cloudinary console
CLOUDINARY_API_SECRET - Your Cloudinary API secret from the Cloudinary console

Usage Examples

Upload an image to Cloudinary

Upload a video with a custom public ID

Upload media by URL

Upload and tag media resources

Notes

Requires Node.js version 18 or higher. Configuration files are located in Windows at: C:\Users\NAME\AppData\Roaming\Claude or macOS at: ~/Library/Application Support/Claude/. They are also accessible via Claude Desktop > Settings > Developer > Edit Config.

Cloudinary MCP Server