About Cloudinary MCP Server
Cloudinary MCP Server lets Claude Desktop and compatible MCP clients upload media to Cloudinary. Its upload tool accepts images and videos and supports options such as resource type, public ID, and tags.
Key features
- 01Upload images and videos
- 02Upload from paths, URLs, or base64 data
- 03Set resource type and public ID
- 04Configure overwrite behavior and tags
Use cases
- 01Upload a local image to Cloudinary
- 02Upload a video asset from a URL
- 03Assign a public ID and tags to uploaded media
MCP support
Exposes an upload tool to MCP clients for sending images or videos to Cloudinary.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMECloudinary 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
- Windows:
-
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 uploadresource_type(optional): Type of resource ('image', 'video', or 'raw')public_id(optional): Custom public ID for the uploaded assetoverwrite(optional): Whether to overwrite existing assets with the same public IDtags(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"
}
});
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.