What is Cloudinary

The Cloudinary MCP Server is a tool designed to facilitate the uploading of images and videos to Cloudinary via Claude Desktop and compatible MCP clients. It simplifies the integration process for managing media assets.

Use cases

This server is particularly useful for developers and content creators who need to upload media files to Cloudinary for web applications, mobile apps, or any platform that requires dynamic media management. It can handle bulk uploads, manage asset organization, and enhance overall media workflows.

How to use

To use the Cloudinary MCP Server, users must first install Node.js, then configure the MCP settings within the Claude Desktop app. Users can either use npx for a straightforward setup or clone the repository for developer installations, ensuring they input their Cloudinary credentials correctly in the configuration files.

Key features

Key features of the Cloudinary MCP Server include the ability to upload various media types (images, videos, and raw files), specify custom public IDs, control asset overwriting, and manage metadata through tagging. The server leverages Cloudinary’s powerful media management capabilities to streamline asset handling.

Where to use

The server can be utilized within the Claude Desktop application and compatible MCP clients, providing a seamless experience for users who require efficient media upload processes to Cloudinary for various applications, including web development and content management systems.

Cloudinary MCP Server

This MCP server provides tools for uploading images and videos to Cloudinary through Claude Desktop and compatible MCP clients.

Installation

Requirements: Node.js

1. Install Node.js (version 18 or higher) and npm from nodejs.org
2. Verify installation:

   node --version
   npm --version
   

Install using npx (Recommended)

1. Navigate to the Claude configuration directory:

   • Windows: C:\Users\NAME\AppData\Roaming\Claude
   • macOS: ~/Library/Application Support/Claude/

   You can also find these directories inside the Claude Desktop app: Claude Desktop > Settings > Developer > Edit Config

2. Add the following configuration to your MCP settings file:

{
  "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"
      }
    }
  }
}

3. Make sure to replace the environment variables with your Cloudinary credentials from the Cloudinary Console.

Developer Installation

If you want to modify the server or contribute to development:

1. Clone the repository:

git clone https://github.com/felores/cloudinary-mcp-server.git
cd cloudinary-mcp-server

2. Install dependencies and build:

npm install
npm run build

Setup Instructions

1. First, ensure you have a Cloudinary account and get your credentials from the Cloudinary Console:

   • Cloud Name
   • API Key
   • API Secret

2. Add the server configuration to your Claude/Cline MCP settings file:

{
  "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"
      }
    }
  }
}

For Claude desktop app, edit the configuration file at the appropriate location for your OS.

3. Install dependencies and build the server:

npm install
npm run build

Available Tools

upload

Upload images and videos to Cloudinary.

Parameters:

• file (required): Path to file, URL, or base64 data URI to upload
• resource_type (optional): Type of resource (‘image’, ‘video’, or ‘raw’)
• public_id (optional): Custom public ID for the uploaded asset
• overwrite (optional): Whether to overwrite existing assets with the same public ID
• tags (optional): Array of tags to assign to the uploaded asset

Example usage in Claude/Cline:

use_mcp_tool({
  server_name: "cloudinary",
  tool_name: "upload",
  arguments: {
    file: "path/to/image.jpg",
    resource_type: "image",
    public_id: "my-custom-id"
  }
});