Integration · Developer tools
Connect Claude & ChatGPT to Cloudinary
Ask your AI to find an image, tag a batch of assets or check how much of your plan you have used, and it works in your Cloudinary media library. It can search and list images, videos and raw files, upload from a URL, rename and move assets, and edit tags, context and structured metadata. Deleting an asset can require your approval first.
Free plan, no credit card. Takes about a minute.
Try asking
“Find all images tagged summer in the marketing folder.”
The AI runs a Cloudinary search expression and lists the matching images with public ID, format and size.
“Upload the image at this URL to our media library.”
It uploads the file from the public URL. Cloudinary detects the file type, and you get the new asset's public ID and URL.
“Add the tag spring-2026 to these 40 product images.”
It adds the tag to all the assets in one call. One call can cover up to 1,000 assets.
What your AI can do
Search and browse
Search assets and folders with Cloudinary search expressions, list images, videos and raw files, and read any asset's URL, size, format, tags and metadata.
Upload and organize
Upload files from a URL or data URI, rename assets and folders, move assets between folders, and restore deleted assets when backups are on.
Tags and metadata
Add, remove or replace tags on up to 1,000 assets at once, and set context and structured metadata fields on an asset.
“How close are we to our storage and bandwidth limits?”
It reads the account's current usage and plan limits for storage, bandwidth, transformations and credits.
“Rename hero-v2 to homepage-hero.”
It changes the asset's public ID. If another asset already has that name, it is only replaced when you allow it.
“What is in the campaigns folder?”
It lists the subfolders and the assets inside the folder, page by page.
110 tools for Cloudinary
These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.
attach_inviteDeletesAttach a invite (folder id). Destructive action; may require approval. API summary: Assign folder roles.create_asset_relations_by_public_idChanges dataUpdate an existing related asset identified by public id. API summary: Create asset relations by public ID.create_concatChanges dataCreate a new concat. Required: urls. API summary: Concatenate ordered video segments into a single MP4 asset.create_contactDeletesCreate a new contact. Required: inspections. Destructive action; may require approval. API summary: Inspect the caller's permitted actions on people.create_document_contextChanges dataCreate a new context for a document. Required: public ids or command. API summary: Adds or clears contextual metadata on multiple assets.create_document_evalChanges dataCreate a new eval for a document. Required: eval. API summary: Evaluate a dynamic upload-parameter expression.create_document_explicitChanges dataCreate a new explicit for a document. Required: public id. API summary: Apply operations on an existing asset.create_document_explodeChanges dataCreate a new explode for a document. Required: public id or transformation. API summary: Create derived images from multi-page file.create_document_generate_archiveChanges dataCreate a new generate archive for a document. API summary: Creates an archive (ZIP or TGZ file) that contains a set of assets from your product environment.create_document_metadataChanges dataCreate a new metadata for a document. Required: public ids or metadata. API summary: Sets structured metadata values on multiple assets.create_document_metadata_fieldChanges dataCreate a new metadata field for a document. Required: type or label. API summary: Creates a new structured metadata field in your account.create_document_metadata_ruleChanges dataCreate a new metadata rule for a document. Required: metadata field id, name, condition or result. API summary: Creates a new conditional metadata rule.create_document_streaming_profileChanges dataCreate a new streaming profile for a document. Required: name or representations. API summary: Creates a new adaptive streaming profile in your Cloudinary account.create_document_textChanges dataCreate a new text for a document. Required: text. API summary: Create image from text.create_document_triggerChanges dataCreate a new trigger for a document. Required: uri or event type. API summary: Creates a new notification trigger (webhook) by specifying an event type and a destination.create_generate_image_to_imageChanges dataCreate a new image to image for a generate. Required: prompt or reference images. API summary: Generate an image from reference images.create_generate_text_to_imageChanges dataCreate a new text to image for a generate. Required: prompt. API summary: Generate an image.create_initial_backupChanges dataCreate a new initial backup. API summary: Create initial backup.create_orderChanges dataCreate a new order. Required: order by. API summary: Order the datasource values of a metadata field.create_trigger_testChanges dataCreate a new test for a trigger. API summary: Tests an existing trigger's filter against sample data.create_updateChanges dataCreate a new update. Required: public id, resource type or kind. API summary: Update the details of a single asset by body parameters.create_visual_searchChanges dataCreate a new visual search. Required: body. API summary: Finds images in your asset library based on visual similarity or content.delete_assetDeletesPermanently delete one asset by `resource_type` and `public_id`. This cannot be undone unless backups are enabled.delete_asset_relations_by_public_idDeletesPermanently delete a related asset by public id. Destructive action; may require approval. API summary: Delete asset relations by public ID.delete_backupDeletesPermanently delete a backup by asset id. Destructive action; may require approval. API summary: Delete backed up versions.delete_destroysDeletesPermanently delete a destroy by cloud name. Destructive action; may require approval. API summary: Delete asset by asset ID.delete_documentDeletesPermanently delete a document by name. Destructive action; may require approval. API summary: Deletes an upload preset from the account.delete_document_derived_resourcesMoves moneyPermanently delete a derived resource by cloud name. Financial or irreversible action; may require approval. API summary: Delete derived resources.delete_document_folderDeletesPermanently delete a folder by folder. Destructive action; may require approval. API summary: Deletes an existing folder from your media library.delete_document_metadata_fieldDeletesPermanently delete a metadata field by external id. Destructive action; may require approval. API summary: Deletes a structured metadata field definition from your account.delete_document_metadata_ruleDeletesPermanently delete a metadata rule by external id. Destructive action; may require approval. API summary: Deletes a conditional metadata rule by its ID.delete_document_resourceDeletesPermanently delete a resource by type. Destructive action; may require approval. API summary: Delete resources by public ID.delete_document_streaming_profileDeletesPermanently delete a streaming profile by name. Destructive action; may require approval. API summary: Delete custom streaming profile or revert built-in profile to the original settings.delete_document_transformationDeletesPermanently delete a transformation by transformation. Destructive action; may require approval. API summary: Deletes a named transformation from your account.delete_document_triggerDeletesPermanently delete a trigger by trigger id. Destructive action; may require approval. API summary: Deletes a notification trigger.delete_invalidate_by_urlsMoves moneyPermanently delete a invalidate by url by cloud name. Financial or irreversible action; may require approval. API summary: Invalidate derived assets by delivery URLs.delete_metadata_field_datasourcesMoves moneyPermanently delete a datasource by external id. Financial or irreversible action; may require approval. API summary: Removes one or more allowed values from a metadata field's datasource.delete_related_assetDeletesPermanently delete a related asset by asset id. Destructive action; may require approval. API summary: Delete asset relations by asset ID.download_assetDownload the document for a asset. API summary: Download an asset by asset ID.download_documentDownload the document for a document. API summary: Generates a download link for a specific asset (image).download_document_backupDownload the document for a document. API summary: Download a backup copy of an asset.get_assetGet one asset's details by `resource_type` (image, video, raw), `type` (usually upload) and `public_id`: URL, size, format, tags, context and metadata.get_asset_by_idGet one asset's details by its immutable `asset_id` instead of its public_id.get_by_container_idGet one by container id by container id. Results are paginated. API summary: List the assets in a folder by container ID.get_documentGet one document for a document by name. API summary: Retrieves details of a single upload preset.get_document_contactGet one contact for a document by contact id. API summary: Get person details.get_document_metadata_fieldGet one metadata field for a document by external id. API summary: Retrieves the definition of a specific structured metadata field by its identifier (externalid).get_document_streaming_profileGet one streaming profile for a document by name. API summary: Retrieves the details of a single adaptive streaming profile by its name.get_document_transformationGet one transformation for a document by transformation. API summary: Retrieves details of a specific transformation.get_generate_taskGet one task for a generate by task id. API summary: Get a generation task.get_initial_backupGet one initial backup by initial backup id. API summary: Get initial backup.get_inviteGet one invite by folder id. API summary: Get folder roles.get_resourceChanges dataGet one resource by cloud name. API summary: Get the details of a single asset by body parameters.get_resource_moderationGet one moderation for a resource by moderation status. Results are paginated. API summary: Get resources by moderation kind and status.get_usageGet the account's current usage and plan limits (storage, bandwidth, transformations, credits), optionally for a specific `date`.list_by_asset_idsList by asset ids. Optional filters: asset ids or resource type. API summary: Get resources by asset IDs.list_by_external_idsList by external ids. Optional filters: external ids, resource type, tags, context, metadata or moderations. API summary: Get resources by external IDs.list_document_contactsList contacts for a document. Optional filters: next cursor, name status, name prefix, status, sort by or direction. Results are paginated. API summary: List recognized people.list_document_metadata_rulesList metadata rules for a document. API summary: Retrieves a list of all conditional metadata rules defined in your account.list_document_resourcesList resources for a document. API summary: Get resource types.list_document_streaming_profilesList streaming profiles for a document. API summary: Lists all adaptive streaming profiles (both built-in and custom) defined in your Cloudinary account.list_document_transformationsList transformations for a document. Optional filters: named or next cursor. Results are paginated. API summary: Lists all transformation definitions in your account, including named transformations.list_document_triggersList triggers for a document. Optional filters: event type. API summary: Lists all webhook notification triggers configured for your product environment.list_folder_assetsList the assets inside one folder by `asset_folder` path, optionally limited to a resource_type. Paginate with next_cursor.list_imagesList uploaded images, optionally filtered by `prefix` (public_id/folder start), `tags` or `type`. Paginate with next_cursor.list_initial_backupsList initial backups. Optional filters: next cursor. Results are paginated.list_metadata_fieldsList the structured metadata fields defined for the media library, with their external IDs and allowed values. Use before setting metadata on assets.list_raw_filesList uploaded non-media files (PDFs, documents and other raw files), optionally filtered by `prefix` or `tags`.list_resource_contextsList contexts for a resource. Optional filters: value, next cursor or direction. Results are paginated. API summary: Get resources by context.list_root_foldersList the top-level folders in the media library.list_subfoldersList the subfolders of a `folder` path.list_tagsList all tags used on assets of a `resource_type`, optionally filtered by `prefix`.list_videosList uploaded videos, optionally filtered by `prefix`, `tags` or `type`. Paginate with next_cursor.list_viewsList views. Optional filters: expression, sort by or next cursor. Results are paginated. API summary: Get video views.rename_assetChanges dataRename an asset by changing its public_id from `from_public_id` to `to_public_id` for a `resource_type`. Set overwrite to replace an existing asset with the target name.rename_folderChanges dataRename or move a folder: pass the current `folder` path and the new `to_folder` path.restore_assetsChanges dataRestore previously deleted assets (when backups are enabled) by their `asset_ids`, optionally to specific versions.restore_datasource_restoreChanges dataRestore a datasource restore (external id). API summary: Restore datasource values.search_assetsChanges dataSearch images, videos and files with a Cloudinary search `expression` (e.g. tags=summer AND resource_type:image), with optional sort_by, with_field and max_results. Use this to find an asset's public_id.search_datasource_values_in_a_metadata_fieldChanges dataSearch datasources by term or exact match. Use this to find existing datasources before creating a new datasource. API summary: Search datasource values in a metadata field.search_datasourcesChanges dataSearch datasources. Use this to find existing datasources before creating a new datasource. API summary: Search across all metadata field datasources.search_foldersSearch folders with an `expression` such as name:product* or path:marketing/*.search_folders_searchChanges dataSearch folders. Use this to find existing folders before creating a new folder. API summary: Searches for folders in your product environment.tag_assetsChanges dataAdd, remove or replace tags on up to 1000 assets: set `command` (add, remove, replace, remove_all), `tags` and the `public_ids` of one `resource_type`.update_assetChanges dataUpdate an asset identified by `resource_type`, `type` and `public_id`: tags, context, structured metadata, display_name or asset_folder (moves it). Only the fields you pass change.update_by_idsVisible to othersUpdate an existing by id identified by cloud name. Has effects visible outside this system. API summary: Get a folder by its identifier.update_by_pathsVisible to othersUpdate an existing by path identified by cloud name. Has effects visible outside this system. API summary: Get a folder by its path.update_descendantsVisible to othersUpdate an existing descendant identified by cloud name. Has effects visible outside this system. API summary: Get the descendants of a folder.update_documentChanges dataUpdate an existing document identified by name. API summary: Updates an existing upload preset's configuration settings.update_document_contactChanges dataUpdate an existing contact identified by contact id. API summary: Update a person.update_document_metadata_fieldChanges dataUpdate an existing metadata field identified by external id. API summary: Updates the configuration of an existing metadata field.update_document_metadata_ruleChanges dataUpdate an existing metadata rule identified by external id. API summary: Updates an existing conditional metadata rule's definition.update_document_streaming_profileChanges dataUpdate an existing streaming profile identified by name. API summary: Modifies an existing adaptive streaming profile's configuration.update_document_transformationChanges dataUpdate an existing transformation identified by transformation. API summary: Updates the definition of an existing transformation.update_document_triggerChanges dataUpdate an existing trigger identified by trigger id. API summary: Updates the callback URL of an existing webhook trigger in your Cloudinary account.update_documentsVisible to othersUpdate an existing document identified by cloud name. Has effects visible outside this system. API summary: Replaces all upload mappings.update_metadata_field_datasourcesVisible to othersUpdate an existing datasource identified by external id. Has effects visible outside this system. API summary: Updates the allowed values (the datasource) for a specified metadata field.update_metadata_field_reordersVisible to othersUpdate an existing reorder identified by external id. Has effects visible outside this system. API summary: Change position of metadata field.update_ordersVisible to othersUpdate an existing order identified by cloud name. Has effects visible outside this system. API summary: Reorder all metadata fields.update_related_assetChanges dataUpdate an existing related asset identified by asset id. API summary: Add related assets by asset ID.update_renamesVisible to othersUpdate an existing rename identified by cloud name. Has effects visible outside this system. API summary: Rename or move a folder.upload_documentChanges dataUpload a document (resource type). API summary: Uploads media assets (images, videos, raw files) to your Cloudinary product environment.upload_document_chunkedChanges dataUpload a document (resource type). API summary: Upload a single chunk of a large file.upload_document_mappingsChanges dataUpload a document (cloud name). Results are paginated. API summary: Retrieves a list of all upload mapping rules configured in your Cloudinary product environment.upload_document_mappings_create_upload_mappingChanges dataUpload a document (cloud name). API summary: Creates a new upload mapping.upload_document_mappings_delete_upload_mappingDeletesUpload a document (cloud name). Destructive action; may require approval. API summary: Deletes a folder upload mapping.upload_document_mappings_uploadChanges dataUpload a document (cloud name). API summary: Updates an existing upload mapping by changing its remote URL template for a given folder.upload_document_presetsChanges dataUpload a document (cloud name). Results are paginated. API summary: Lists all upload presets configured in the account.upload_document_presets_uploadChanges dataUpload a document (cloud name). API summary: Creates a new upload preset with specified configuration settings.upload_fileChanges dataUpload a file to the media library. `file` is a public HTTP(S) URL or a Base64 data URI; the file type is detected automatically. Optionally set `upload_preset`.
Set up in three steps
- 1
Pick the app
Create a free HeyMyApps account and choose Cloudinary from the app list.
- 2
Paste your key
Paste your Cloudinary API Key and API Secret, and enter your Cloud name. In the Cloudinary Console open Settings > API Keys (or the Dashboard) and copy all three. The same key and secret work for both the Admin and Upload APIs.
- 3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
- Click your name, then Settings › Connectors › Add custom connector.
- Paste your link as the Remote MCP server URL.
- Switch it on from the + menu in a chat.
Questions
What can the AI do in Cloudinary?
It can search and list images, videos, raw files, folders and tags, read asset details and structured metadata fields, and check your usage and plan limits. It can upload files, rename assets and folders, update tags, context, metadata and folder placement, restore deleted assets and permanently delete an asset.
Does the AI see my Cloudinary credentials?
No. Your Cloudinary credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.
Can I control what the AI is allowed to do?
Yes. You choose which tools are switched on, so you can start with search and lookups only. Deleting an asset is permanent unless backups are enabled, and renaming with overwrite replaces an existing asset, so these can require your approval before they run. Every tool call is logged.
Does it work with ChatGPT?
Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.
What does it cost?
HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Cloudinary account.
How does the AI upload files?
The upload tool takes a public HTTP(S) URL or a Base64 data URI. Cloudinary fetches the file and detects the file type automatically. You can also name an upload preset, so the preset's settings from your Cloudinary account apply to the upload.
Let your AI work in Cloudinary today.
Start free. Your key stays encrypted, and you decide what the AI may do.
Connect Cloudinary freeHeyMyApps is not affiliated with Cloudinary. Product names are trademarks of their owners.






