# Cloudinary MCP server > Upload, search, organize and transform images, videos and files in your Cloudinary media library, and generate images with AI. - Listing: https://mcp.tc/i/cloudinary - Connect: use the server's own URL `https://asset-management.mcp.cloudinary.com/mcp` (OAuth sign-in at the server); clients connect to it directly. The listing link is a page, not an MCP endpoint. - Type: remote (Streamable HTTP) - Auth: OAuth sign-in - Category: [Design, Websites & CMS](https://mcp.tc/c/design) - Vendor: Cloudinary - Homepage: - Docs: - Repository: - Package: npm `@cloudinary/asset-management-mcp` ## About Connects to the asset management API of a Cloudinary product environment. You can upload assets from local paths, URLs or data URIs, list and search images, videos and raw files, manage tags, context and structured metadata, organize folders, apply transformations, and generate images from text or reference images. Runs as a hosted streamable HTTP endpoint with OAuth sign-in by default. Header authentication also works with a cloudinary-url header or the cloudinary-cloud-name, cloudinary-api-key and cloudinary-api-secret headers. A local npm package, @cloudinary/asset-management-mcp, is available and needs the same credentials as environment variables. ## What it can do - Upload images, videos and raw files from paths, URLs or data URIs - Search assets with queries or by visual similarity - Add, remove or replace tags and metadata on many assets - Create, move and delete folders in the media library - Apply transformations to existing assets - Generate images from text prompts or reference images - Create ZIP or TGZ archives of assets - Check account usage and credits ## Tools (29) - `upload-asset`: Upload images, videos or raw files from file paths, URLs or base64 data URIs. - `asset-rename`: Change an asset's public ID and optionally other metadata. - `generate-archive`: Create a ZIP or TGZ archive containing a set of assets. - `download-asset-backup`: Download a backup copy of an asset. - `delete-asset`: Delete an asset by its asset ID. - `list-images`: List image assets, filtered by tags, prefix or public IDs. - `list-videos`: List video assets, filtered by tags, prefix or public IDs. - `list-files`: List raw assets, filtered by tags, prefix or public IDs. - `get-asset-details`: Return the details of one asset by asset ID. - `asset-update`: Update an asset's metadata, tags and other attributes by asset ID. - `list-tags`: List tags applied to assets of a given type. - `delete-derived-assets`: Delete derived resources by derived resource ID. - `manage-asset-tags`: Add, remove or replace tags on multiple assets by public ID. - `manage-asset-context`: Add or clear contextual metadata on multiple assets. - `manage-asset-metadata`: Set structured metadata values on multiple assets. - `get-usage-details`: Report storage, credits, bandwidth, requests and add-on usage. - `create-asset-relations`: Relate an asset to other assets by asset ID. - `delete-asset-relations`: Remove relations between an asset and other assets. - `move-folder`: Rename or move a folder with all its assets. - `create-folder`: Create a new empty folder at a given path. - `delete-folder`: Delete a folder and the assets within it. - `search-folders`: Find folders matching a search expression. - `search-assets`: Search assets with a Lucene-like query over attributes, dates and metadata. - `visual-search-assets`: Find images by visual similarity to a URL, asset ID or text description. - `generate-image`: Generate an image from a text prompt using AI models. - `generate-image-from-images`: Generate or edit an image guided by reference images and a prompt. - `get-generation-task`: Get the status of an image generation task. - `get-tx-reference`: Fetch Cloudinary transformation documentation before building transformations. - `transform-asset`: Create derived transformations of existing assets using eager transformations. ## Example prompts - "Upload this local image to Cloudinary and tag it summer-campaign" - "Find all videos tagged product-demo uploaded this month" - "Generate an image of a red bicycle on a beach and check the task status" - "Show my Cloudinary storage and bandwidth usage" ## Install ### Claude Code 1. Run this in a terminal, in your project folder: ```bash claude mcp add --transport http cloudinary https://asset-management.mcp.cloudinary.com/mcp ``` 2. Start Claude Code, type `/mcp`, pick **cloudinary** and choose **Authenticate**. A browser window opens for the Cloudinary sign-in. Add `--scope user` to make it available in every project, not just this one. ### Claude Desktop 1. Open **Settings → Connectors** and click **Add custom connector**. 2. Name it **Cloudinary** and paste this URL: ```url https://asset-management.mcp.cloudinary.com/mcp ``` 3. Click **Add**, then **Connect**, and sign in when Cloudinary asks. Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too. ### claude.ai 1. Open the connector form on claude.ai. This button fills in the name and URL for you: [Add to claude.ai]() (opens connector settings) 2. Check that the URL reads `https://asset-management.mcp.cloudinary.com/mcp` and click **Add**. 3. Click **Connect** and sign in when Cloudinary asks. Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**. ### ChatGPT 1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. 2. Go to `chatgpt.com/plugins` and click **+** to create an app for a remote MCP server. 3. Paste `https://asset-management.mcp.cloudinary.com/mcp` as the server URL and choose **OAuth**. ChatGPT sends you to Cloudinary to sign in. Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts. ### Cursor [Add to Cursor]() (opens Cursor) Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project): `mcp.json`: ```json { "mcpServers": { "cloudinary": { "url": "https://asset-management.mcp.cloudinary.com/mcp" } } } ``` Cursor shows **Needs login** next to the server. Click it to sign in. ### VS Code [Install in VS Code]() (opens VS Code) Or from a terminal: ```bash code --add-mcp '{"name":"cloudinary","type":"http","url":"https://asset-management.mcp.cloudinary.com/mcp"}' ``` Or commit it to the repo in `.vscode/mcp.json`: `.vscode/mcp.json`: ```json { "servers": { "cloudinary": { "type": "http", "url": "https://asset-management.mcp.cloudinary.com/mcp" } } } ``` VS Code asks you to sign in the first time the server starts. ### Devin Desktop 1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows): `mcp_config.json`: ```json { "mcpServers": { "cloudinary": { "serverUrl": "https://asset-management.mcp.cloudinary.com/mcp" } } } ``` 2. Refresh the MCP server list in Cascade and sign in when asked. Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers. ### Codex ```bash codex mcp add cloudinary --url https://asset-management.mcp.cloudinary.com/mcp codex mcp login cloudinary ``` Or edit `~/.codex/config.toml` directly: `config.toml`: ```toml [mcp_servers.cloudinary] url = "https://asset-management.mcp.cloudinary.com/mcp" ``` ### Gemini CLI ```bash gemini mcp add --transport http cloudinary https://asset-management.mcp.cloudinary.com/mcp ``` Then, inside Gemini CLI, run `/mcp auth cloudinary` to sign in. This adds it to the current project. Add `-s user` to use it everywhere. ### Any client Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file. ```json { "mcpServers": { "cloudinary": { "type": "http", "url": "https://asset-management.mcp.cloudinary.com/mcp" } } } ``` Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE. Client only starts local servers? Bridge it with `npx -y mcp-remote https://asset-management.mcp.cloudinary.com/mcp`. ## Details - Server version: 0.8.1 - Last checked: 2026-10-03 (reachable, asks for credentials) - Listed: 2026-10-03 - Updated: 2026-10-03 --- Source: https://mcp.tc/i/cloudinary (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report