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

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

Install using npx (Recommended)

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

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:

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

Setup Instructions

First, ensure you have a Cloudinary account and get your credentials from the Cloudinary Console:
- Cloud Name
- API Key
- API Secret
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.

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

upload

This server provides tools for uploading images and videos directly to Cloudinary using Claude/Cline, facilitating resource management with customizable options like resource type and public ID.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Image Placeholder Server
husniadil
A
security
A
license
A
quality
This server generates placeholder image URLs from various providers, supporting input validation and integration with desktop applications like Claude and Cursor.
Last updated -
1
8
MIT License
cloudinary-mcp-server
yoavniran
A
security
A
license
A
quality
A Model Context Protocol server that exposes Cloudinary Upload & Admin API methods as tools by AI assistants. This integration allows AI systems to trigger and interact with your Cloudinary cloud.
Last updated -
5
625
JavaScript
MIT License
Qiniu Cloud Storage MCP Server
joeseesun
-
security
F
license
-
quality
A server that enables uploading files to Qiniu Cloud Storage through a standardized MCP interface, providing a simple way to store and serve files with public URLs.
Last updated -
26
Python
Image Worker MCP
BoomLinkAi
-
security
A
license
-
quality
A lightweight MCP server for image processing and cloud uploads that automates resizing, converting, optimizing, and uploading images to services like AWS S3, Cloudflare R2, and Google Cloud Storage.
Last updated -
6
13
TypeScript
MIT License

View all related MCP servers

Cloudinary MCP Server