Cloudinary MCP Server

What is Cloudinary MCP Server about?

Enables Claude Desktop and other MCP clients to upload images, videos, or raw files directly to a Cloudinary account, handling authentication and upload parameters automatically.

How to use Cloudinary MCP Server?

1. Install Node.js (v18+).
2. Add the MCP server configuration to the Claude configuration file (Windows: C:\Users\NAME\AppData\Roaming\Claude; macOS: ~/Library/Application Support/Claude/).

{
  "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. In Claude, invoke the upload tool with required arguments, e.g.,

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

Key Features

• Simple MCP‑based interface for uploads.
• Supports file paths, URLs, and base64 data URIs.
• Optional parameters: resource_type, public_id, overwrite, tags.
• Automatic handling of Cloudinary credentials via environment variables.
• Works on Windows, macOS, and Linux through Node.js.

Use Cases

• Quickly attach images or videos to AI‑generated content in Claude.
• Automate media asset management for chat‑based workflows.
• Integrate Cloudinary uploads into custom MCP‑enabled tools or bots.
• Enable end‑users to upload media without leaving the Claude UI.

FAQ

Q: Which file types can I upload? A: Any format supported by Cloudinary—images (jpg, png, gif, etc.), videos (mp4, webm, etc.), and raw files.

Q: Do I need to install the server locally? A: No. Using the npx command runs the package directly without a permanent installation.

Q: How are credentials secured? A: Credentials are passed as environment variables defined in the MCP configuration, keeping them out of the code.

Q: Can I overwrite an existing asset? A: Yes, set the overwrite argument to true when calling the upload tool.

Q: What if I want to customize the server? A: Clone the repository, run npm install && npm run build, and point the command to the built dist/index.js file.

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"
  }
});