Cloudinary MCP Server

by felores
Verified

Cloudinary MCP Server

This MCP server provides tools for uploading images and videos to Cloudinary through Claude Desktop and compatible MCP clients.

<a href="https://glama.ai/mcp/servers/zjiw1ry8ly"><img width="380" height="200" src="https://glama.ai/mcp/servers/zjiw1ry8ly/badge" alt="Cloudinary Server MCP server" /></a>

Installation

Requirements: Node.js

  1. Install Node.js (version 18 or higher) and npm from nodejs.org
  2. Verify installation:
    node --version npm --version
  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"], "env": { "CLOUDINARY_CLOUD_NAME": "your_cloud_name", "CLOUDINARY_API_KEY": "your_api_key", "CLOUDINARY_API_SECRET": "your_api_secret" } } } }
  1. 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
  1. 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.

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Installation
    1. Requirements: Node.js
      1. Install using npx (Recommended)
        1. Developer Installation
        2. Setup Instructions
          1. Available Tools
            1. upload