Cloudinary

by felores

8 stars
266 downloads
Not rated
GitHub

About

Integrates with Cloudinary to enable seamless image and video uploads with customizable parameters for dynamic content management.

Details

Author
felores
Repository
felores/cloudinary-mcp-server
GitHub stars
8
Downloads
266
License
MIT License
Categories
File Management, Other, Productivity, Developer Tools, Design, AI, Media, Cloud Service, Infrastructure
Tags
#integration

- Upload images, videos, and raw files to Cloudinary.
- Accepts file paths, URLs, or base64 data URIs.
- Optional parameters: resource type, public ID, overwrite, tags.
- Simple setup via npx or local developer installation.
- Integrates with Claude Desktop and MCP‑compatible clients.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Cloudinary
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 @felores/cloudinary-mcp-server@latest
    Environment
    • CLOUDINARY_API_KEY your_api_key
    • CLOUDINARY_API_SECRET your_api_secret
    • CLOUDINARY_CLOUD_NAME your_cloud_name

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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@latest"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name",
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret"
      }
    }
  }
}

3. Make sure to replace the environment variables with your Cloudinary credentials from the Cloudinary Console.

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

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.

3. Install dependencies and build the server:

npm install
npm run build

upload

Upload images and videos to Cloudinary. Parameters: file (required, string) - Path to file, URL, or base64 data URI to upload; resource_type (optional, string) - Type of resource ('image', 'video', or 'raw'); public_id (optional, string) - Custom public ID for the uploaded asset; overwrite (optional, boolean) - Whether to overwrite existing assets with the same public ID; tags (optional, array) - Array of tags to assign to the uploaded asset.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cloudinary": {
            "env": {
                "CLOUDINARY_API_KEY": "your_api_key",
                "CLOUDINARY_API_SECRET": "your_api_secret",
                "CLOUDINARY_CLOUD_NAME": "your_cloud_name"
            },
            "args": [
                "@felores/cloudinary-mcp-server@latest"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret",
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name"
    },
    "args": [
        "@felores/cloudinary-mcp-server@latest"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret",
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name"
    },
    "args": [
        "@felores/cloudinary-mcp-server@latest"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "CLOUDINARY_API_KEY": "your_api_key",
        "CLOUDINARY_API_SECRET": "your_api_secret",
        "CLOUDINARY_CLOUD_NAME": "your_cloud_name"
    },
    "args": [
        "@felores/cloudinary-mcp-server@latest"
    ],
    "command": "npx"
}

This MCP server provides tools for uploading images and videos to Cloudinary through Claude Desktop and compatible MCP clients.
- Install Node.js (version 18 or higher) and npm fromnodejs.org
- Verify installation:

node --version npm --version

-

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 theCloudinary Console.

If you want to modify the server or contribute to development:

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

-

First, ensure you have a Cloudinary account and get your credentials from theCloudinary Console:

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:

- 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

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

Interact with the Intelligent Content Management platform through Box AI.

An MCP server for interacting with AIStor and MinIO object stores.

Access various storage services like S3, GCS, and Azure Blob through the Apache OpenDAL™ project, configured via environment variables.

Manage AWS S3 buckets and objects, including policies, tagging, and configurations.

Manage AWS S3 operations, providing secure access to S3 buckets through pre-signed URLs.

DeFi agent definitions JSON API - Production-ready agents for Web3, crypto trading, portfolio management, and blockchain automation

GCP Bucket Connector (data-connectors-ai)

Read-only MCP server for GCP Cloud Storage: list objects in a bucket.

Access and manage your Google Photos library with AI assistants.

A server for backing up and restoring data for AI agents and code editing tools.

Uploads local images to Bilibili's image hosting service and returns a permanent HTTPS link.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.