Cloudinary Media Upload MCP Server

Cloudinary Media Upload provides a seamless integration between Claude Desktop and Cloudinary's media management platform. This tool allows you to upload, store, and manage images and videos directly through Claude's interface, leveraging Cloudinary's powerful cloud-based media handling capabilities. With this integration, you can easily upload media files to your Cloudinary account, specify resource types, add custom IDs, and apply tags - all without leaving your Claude Desktop environment. This streamlines your workflow when you need to reference or work with media assets during conversations with Claude.

Overview

Cloudinary Media Upload enables you to interact with Cloudinary's media management platform directly from Claude Desktop. This integration allows you to upload images, videos, and other media files to your Cloudinary account without switching between applications.

Prerequisites

Before using this integration, you'll need:

A Cloudinary account (sign up at cloudinary.com if you don't have one)
Your Cloudinary credentials (Cloud Name, API Key, and API Secret) from the Cloudinary Console
Node.js version 18 or higher installed on your system

Installation

Method 1: Using npx (Recommended)

Navigate to your Claude configuration directory:
- Windows: C:\Users\[USERNAME]\AppData\Roaming\Claude
- macOS: ~/Library/Application Support/Claude/
You can also find these directories through Claude Desktop by going to Settings > Developer > Edit Config.
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"
      }
    }
  }
}

Replace the placeholder values with your actual Cloudinary credentials.

Method 2: Manual Installation (For Development)

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

Clone the repository:

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

Install dependencies and build:

npm install
npm run build

Configure your Claude settings file to point to your local installation:

{
  "mcpServers": {
    "cloudinary": {
      "command": "node",
      "args": ["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"
      }
    }
  }
}

Usage

Once installed, you can use the Cloudinary Media Upload tool in your conversations with Claude. To upload media, use the following syntax:

use_mcp_tool({
  server_name: "cloudinary",
  tool_name: "upload",
  arguments: {
    file: "path/to/image.jpg",
    resource_type: "image",
    public_id: "my-custom-id",
    overwrite: true,
    tags: ["sample", "test"]
  }
});

The tool will return information about the uploaded asset, including its URL, which you can then use in your conversation with Claude.

Troubleshooting

If you encounter issues:

Verify your Cloudinary credentials are correct
Check that Node.js is properly installed (version 18+)
Ensure the configuration file is properly formatted
Look for any error messages in the Claude Desktop console

For more detailed help, visit the GitHub repository or contact the developer.

Cloudinary Media Upload MCP Server

upload