How to connect Cloudinary to Claude

Connect Claude Web, Desktop and Cowork to Cloudinary MCP. Create a new folder for event photos, delete derived assets with ids [123,456], and more using natural language, with authentication handled for you.

Cloudinary logoCloudinary
Api Key

Cloudinary is a cloud-based platform for managing, uploading, and transforming images and videos. It streamlines media workflows and delivers optimized assets globally.

109 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Cloudinary account to Claude via Composio Connect, enabling it to create a new folder for event photos, delete derived assets with IDs [123,456], set up upload preset with watermarking, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Cloudinary with

Connecting Cloudinary to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Cloudinary account

Back in Claude, ask it to connect to Cloudinary or give it any Cloudinary-related task.

For example, ask Claude to:

  • "Create a new folder for event photos"
  • "Delete derived assets with IDs [123,456]"
  • "Set up upload preset with watermarking"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Cloudinary account is ready to use.

What is the Cloudinary Claude Connector, and what's possible with it?

The Cloudinary MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Cloudinary account. It provides structured and secure access to your digital asset management system, so your agent can perform actions like organizing folders, creating metadata fields, managing upload presets, and handling asset deletion on your behalf.

  • Automated folder and asset organization: Easily instruct your agent to create new asset folders or remove empty ones, keeping your Cloudinary library tidy and structured.
  • Metadata management: Let your agent create custom metadata fields or delete obsolete ones, extending and refining your asset tagging and search capabilities.
  • Preset and upload mapping creation: Have your agent set up upload presets with specific options or define dynamic folder mappings, automating consistent upload processes across your assets.
  • Resource and derived asset cleanup: Direct your agent to permanently delete assets by ID or remove unnecessary derived resources, ensuring your storage stays efficient and clutter-free.
  • Datasource entry management: Ask your agent to inactivate or delete specific datasource entries from metadata fields, keeping your metadata schema accurate and up to date.

Troubleshooting

1. Why does Claude not use the Composio connector for Cloudinary?

The connector can show as connected, but Claude must use it in each Cloudinary conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Cloudinary again.

2. Why does Claude show an MCP server error before Cloudinary connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Cloudinary.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Cloudinary.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Cloudinary authorization link not work?

The Composio connector is one server. Your Cloudinary account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Cloudinary connection.
  • Composio creates a fresh Cloudinary authorization link.
  • Open that link in your browser and finish the Cloudinary sign-in.

4. Why do Cloudinary actions fail after they worked before?

The Cloudinary connection can expire or lose permission.

  • Ask Claude to inspect the Cloudinary connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Cloudinary account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Cloudinary.
  • If the action still fails with a permission error, check that the connected account has that permission in Cloudinary itself.

5. How do I switch to a different Cloudinary account?

Claude can manage the Cloudinary connection for you.

  • Ask Claude to disconnect or delete the current Cloudinary account.
  • Ask Claude to connect Cloudinary again.
  • Open the new Composio authorization link for Cloudinary.
  • Sign in with the other Cloudinary account in the browser.
  • After the account connects, ask Claude to retry the Cloudinary task.

6. Why is my Cloudinary connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Cloudinary connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Cloudinary tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Cloudinary.
TOOLS

Supported Tools

Every Cloudinary action and event your agent gets out of the box.

Activate Live Stream

Tool to manually activate a Cloudinary live stream.

Create Asset Relations by Asset ID

Tool to add related assets by asset ID.

Create Asset Relations by Public ID

Tool to create relations between assets by public ID.

Create Folder

Tool to create a new asset folder.

Create Image from Text

Tool to create an image from text using Cloudinary's text generation API.

Create Live Stream

Create a new Cloudinary live stream for a streaming session.

Create Live Stream Output

Tool to create a new live stream output configuration.

Create Metadata Field

Tool to create a new metadata field definition.

Create Metadata Rule

Tool to create a new conditional metadata rule.

Create Multi-Resource Animation

Tool to create an animated image, video, or PDF from a set of images.

Create Slideshow

Tool to create an auto-generated video slideshow from existing Cloudinary assets.

Create Streaming Profile

Tool to create a new adaptive streaming profile in your Cloudinary account.

Create Transformation

Tool to create a new named transformation by assigning a custom name to a set of transformation parameters.

Create Trigger

Tool to create a new webhook trigger for a specified event type.

Create Upload Mapping

Tool to create a new upload mapping folder and URL template.

Create Upload Preset

Tool to create a new upload preset.

Delete Asset Relations by Asset ID

Tool to delete asset relations by asset ID.

Delete Asset Relations by Public ID

Delete relations between a specified asset and other assets by public ID.

Delete Derived Resources

Tool to delete derived assets.

Delete Metadata Field Datasource Entries

Delete specified datasource entries from a metadata field by their external IDs.

Delete Folder

Tool to delete an empty asset folder.

Delete Live Stream

Tool to delete a live stream from Cloudinary.

Delete Live Stream Output

Tool to delete a live stream output from Cloudinary.

Delete Metadata Field

Tool to delete a metadata field by external ID.

Delete Metadata Rule

Tool to delete a conditional metadata rule by its ID.

Delete Resources by Asset ID

Delete Cloudinary resources by immutable asset ID, specifying 1 to 100 IDs.

Delete Resources by Public ID

Delete Cloudinary resources by public IDs, prefix, or all resources of a specified resource and delivery type.

Delete Resources by Tags

Delete Cloudinary assets with a specified tag and resource type, optionally keeping originals and deleting derived assets.

Delete Streaming Profile

Tool to delete a custom streaming profile or revert a built-in profile to original settings.

Delete Transformation (v2)

Tool to delete a named transformation from your Cloudinary account.

Delete Trigger

Tool to delete a trigger (webhook notification).

Delete Upload Mapping

Tool to delete a folder upload mapping.

Delete Upload Preset

Tool to delete an upload preset from the account.

Destroy Asset

Tool to permanently destroy a Cloudinary asset/resource by public ID.

Destroy Asset by ID

Tool to delete an asset by its immutable asset ID.

Download Asset by Asset ID

Download one Cloudinary asset by immutable asset ID and return a downloadable file reference.

Explicit Resource Update

Tool to update an existing asset and/or eagerly generate derived transformations using Cloudinary's Explicit API.

Explode Multi-Page Resource

Create derived images from the pages or frames of a multi-page resource, such as a PDF or animated image.

Generate Archive

Tool to create an archive (ZIP or TGZ file) containing a set of assets from your Cloudinary environment.

Get Adaptive Streaming Profiles

Tool to list adaptive streaming profiles.

Get Analysis Task Status

Tool to get the status of an analysis task.

Get product environment config details

Tool to get product environment config details.

Get Live Stream

Tool to get details of a single live stream by ID.

Get Live Stream Output

Tool to get details of a single live stream output.

Get Live Stream Outputs

Tool to get a list of live stream outputs.

Get Live Streams

Tool to get a list of live streams from Cloudinary.

Get Metadata Field By ID

Tool to get a single metadata field definition by external ID.

Get Resource by Asset ID

Get Resource by Asset ID

Get Resource by Public ID

Get details of a single resource by public ID, resource type, and delivery type, which must match the stored asset.

Get Resources by Asset Folder

Tool to list assets stored directly in a specified folder.

Get Resources by Context

Tool to retrieve assets with a specified contextual metadata key/value.

Get Resources in Moderation

Tool to retrieve assets in a moderation queue by status.

Get Root Folders

List top-level asset folders in the product environment.

Get Streaming Profile Details

Tool to get details of a single streaming profile by name.

Get Resource Tags

Tool to list all tags used for a specified resource type.

Get Transformation

Tool to retrieve details of a specific transformation.

Get Transformations

Tool to list all transformations (named and unnamed).

List Webhook Triggers

Tool to list all webhook triggers for event types in your environment.

Get Upload Mapping Details

Tool to retrieve details of a single upload mapping by folder.

Get Upload Mappings

Tool to list all upload mappings.

Get Upload Preset

Tool to retrieve details of a single upload preset by name.

Get Usage

Tool to get product environment usage details.

Get Video Views

Tool to get video analytics views from Cloudinary.

Idle Live Stream

Tool to manually idle a Cloudinary live stream.

List Images

List Cloudinary image assets with optional filtering by public ID prefix or public IDs, and pagination.

List Metadata Fields

Tool to list all structured metadata fields defined in your Cloudinary product environment.

List Metadata Rules

Tool to retrieve all conditional metadata rules defined in your Cloudinary account.

List Raw Files

List raw assets from Cloudinary with optional filtering by prefix or public IDs.

List Resources by Asset IDs

Tool to retrieve multiple resources by their asset IDs.

List Resources by External IDs

Tool to retrieve resources by their external IDs.

List Resources by Tag

Tool to list resources (assets) with a specified tag.

List Resources by Type

Tool to retrieve resources (assets) by resource type and storage type.

List Resource Types

Tool to list all available resource types in your Cloudinary product environment.

List Upload Presets

Tool to list all upload presets configured in the account.

List Video Assets

List video assets with optional filtering by prefix, public IDs, or creation timestamp, and optionally include their tags.

Manage Context Metadata

Add or update contextual metadata on existing Cloudinary assets, or remove all contextual metadata from the selected assets.

Order Metadata Field Datasource

Tool to update ordering of a metadata field datasource.

Ping Cloudinary Servers

Tool to ping Cloudinary servers.

Publish Resources

Tool to publish Cloudinary assets by public IDs, prefix, or tag.

Rename or Move Resource Public ID

Tool to rename an asset's public ID using Cloudinary's rename endpoint.

Reorder Metadata Field

Tool to change the position of a specific metadata field.

Reorder Metadata Fields

Tool to reorder all metadata fields in the product environment.

Restore Metadata Field Datasource Entries

Tool to restore previously deleted datasource entries for a metadata field.

Restore Deleted Resources

Tool to restore deleted Cloudinary resources by public IDs.

Restore Resources by Asset IDs

Tool to restore backed up assets by asset IDs.

Search Assets

Tool to search and filter assets using powerful query expressions.

Search Datasource in Metadata Field

Tool to search datasource values in a metadata field.

Search Folders

Tool to search asset folders with filtering, sorting, and pagination.

Search All Metadata Field Datasources

Tool to search across all metadata field datasources.

Visual Search Assets

Tool to find images in your asset library based on visual similarity or content.

Show Folder

Tool to list sub-folders within a specified folder.

Update Asset Metadata

Tool to populate or update metadata field values on one or more Cloudinary assets.

Update Folder

Tool to rename or move an existing asset folder.

Update Live Stream

Tool to update a live stream's configuration in Cloudinary.

Update Live Stream Output

Tool to modify an existing live stream output configuration.

Update Metadata Field

Tool to update a metadata field definition by external ID.

Update Metadata Field Datasource

Tool to update the datasource (allowed values) for a metadata field.

Update Metadata Rule

Tool to update an existing conditional metadata rule.

Update Resource by Asset ID

Tool to update asset properties by asset ID in Cloudinary.

Update Resource by Public ID

Tool to update asset properties by public ID in Cloudinary.

Update Resource Tags

Tool to add, remove, replace, or remove all tags for one or more Cloudinary assets.

Update Streaming Profile

Tool to modify an existing adaptive streaming profile's configuration.

Update Transformation (v2)

Tool to update the definition of an existing named transformation.

Update Trigger

Tool to update the callback URL of an existing webhook trigger.

Update Upload Mapping

Tool to update an existing upload mapping by changing its remote URL template.

Update Upload Preset

Tool to update an existing upload preset's configuration settings.

Upload Asset

Tool to upload media assets (images, videos, raw files) to Cloudinary.

Upload File Chunk

Upload a single chunk of a large file to Cloudinary.

Upload File (Auto Detect)

Upload a file to Cloudinary without specifying a resource type.

FAQ

Frequently asked questions

Start with Cloudinary.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Cloudinary tool your agent needs.Free to start.

Start building