Cloudinary MCP Server

This MCP server facilitates uploading images and videos to Cloudinary via Claude Desktop and compatible MCP clients.

Installation

Requirements: Node.js

Ensure Node.js (version 18+) and npm are installed from nodejs.org. Verify with node --version and npm --version.

Install using npx (Recommended)

1. Locate the Claude configuration directory (e.g., C:\Users\NAME\AppData\Roaming\Claude on Windows).
2. Add the following configuration to your MCP settings file, replacing placeholders with your Cloudinary credentials:

{
  "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"
      }
    }
  }
}

Developer Installation

For modification or contribution:

1. Clone the repository: git clone https://github.com/felores/cloudinary-mcp-server.git
2. Install dependencies and build: npm install && npm run build

upload

Upload images and videos to Cloudinary.

Parameters:

• file (required): Path to file, URL, or base64 data URI.
• resource_type (optional): 'image', 'video', or 'raw'.
• public_id (optional): Custom public ID.
• overwrite (optional): Overwrite existing assets.
• tags (optional): Array of tags.

Example usage:

use_mcp_tool({
  server_name: "cloudinary",
  tool_name: "upload",
  arguments: {
    file: "path/to/image.jpg",
    resource_type: "image",
    public_id: "my-custom-id"
  }
});