Cloudinary

🚀 Cloudinary MCP Server

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

🚀 Quick Start

📦 Installation

Prerequisites: Node.js

1. Install Node.js (version 18 or higher) and npm from nodejs.org.
2. Verify the installation:

node --version
npm --version

Installation 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 paths in the Claude Desktop app: Claude Desktop > Settings > Developer > Edit Configuration.

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. Ensure you replace the environment variables with your actual Cloudinary credentials obtained 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

📚 Documentation

Setup Instructions

1. First, ensure you have a Cloudinary account and obtain 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 the Claude Desktop app, edit the configuration file in the corresponding location.

3. Install dependencies and build the server:

npm install
npm run build

💻 Usage Examples

upload

Upload images and videos to Cloudinary.

Parameters:

• file (Required): Path, URL, or base64 data URI of the file to upload.
• resource_type (Optional): Resource type ('image', 'video', or 'raw').
• public_id (Optional): Custom public ID for the uploaded asset.
• overwrite (Optional): Whether to overwrite an existing asset 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"
  }
});