Cloudinary

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:
```
1node --version
2npm --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:

1{
2  "mcpServers": {
3    "cloudinary": {
4      "command": "npx",
5      "args": ["@felores/cloudinary-mcp-server@latest"],
6      "env": {
7        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
8        "CLOUDINARY_API_KEY": "your_api_key",
9        "CLOUDINARY_API_SECRET": "your_api_secret"
10      }
11    }
12  }
13}

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:

1git clone https://github.com/felores/cloudinary-mcp-server.git
2cd cloudinary-mcp-server

Install dependencies and build:

1npm install
2npm 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:

1{
2  "mcpServers": {
3    "cloudinary": {
4      "command": "node",
5      "args": ["c:/path/to/cloudinary-mcp-server/dist/index.js"],
6      "env": {
7        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
8        "CLOUDINARY_API_KEY": "your_api_key",
9        "CLOUDINARY_API_SECRET": "your_api_secret"
10      }
11    }
12  }
13}

For Claude desktop app, edit the configuration file at the appropriate location for your OS.

Install dependencies and build the server:

1npm install
2npm 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:

1use_mcp_tool({
2  server_name: "cloudinary",
3  tool_name: "upload",
4  arguments: {
5    file: "path/to/image.jpg",
6    resource_type: "image",
7    public_id: "my-custom-id"
8  }
9});

Contents