What can you do with this server?

The Cloudinary MCP Server enables you to upload and manage media files on Cloudinary via Claude Desktop and compatible MCP clients. * Upload Media: Upload images, videos, and raw files using a file path, URL, or base64 data URI * Customization: Set custom public IDs, add tags for organization, and control overwrite options for existing assets * Large File Handling: Process large files in chunks with streaming responses for video uploads * URL Generation: Access uploaded assets via auto-generated HTTPS/HTTP URLs * Integration: Seamlessly integrates with Claude Desktop via MCP server configuration

How do I use Cloudinary MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Cloudinary MCP Server upload this screenshot I just took and tag it as 'bug-report'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Cloudinary MCP Server

Q: Which integrations are available for this server?

Provides tools for uploading images and videos to Cloudinary through Claude Desktop and compatible MCP clients

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

Related MCP server: cloudinary-mcp-server

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