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.

108 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.

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

Tool to create a new live stream in Cloudinary.

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

Tool to delete asset relations by public ID.

Delete Derived Resources

Tool to delete derived assets.

Delete Metadata Field Datasource Entries

Tool to delete datasource entries for a specified metadata field.

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

Tool to delete resources by asset IDs.

Delete Resources by Public ID

Tool to delete Cloudinary resources by public ID, prefix, or all resources.

Delete Resources by Tags

Tool to delete Cloudinary assets by tag.

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.

Explicit Resource Update

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

Explode Multi-Page Resource

Tool to create derived images from multi-page files (PDF, PSD, TIFF, animated GIF) by exploding them into separate images.

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

Tool to get details of a single resource by public ID.

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

Tool to list all root 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

Tool to list image assets from Cloudinary.

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

Tool to list raw assets from Cloudinary.

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

Tool to list video assets from Cloudinary.

Manage Context Metadata

Tool to add or remove contextual metadata on Cloudinary 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

Tool to upload a single chunk of a large file to Cloudinary.

Upload File (Auto Detect)

Tool to upload files with automatic resource type detection.

FAQ

Frequently asked questions

With a standalone Cloudinary MCP server, the agents and LLMs can only access a fixed set of Cloudinary tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Cloudinary and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Cloudinary tools.

Yes, absolutely. You can configure which Cloudinary scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Cloudinary data and credentials are handled as safely as possible.

Start with Cloudinary.It takes 30 seconds.

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

Start building