Cloudinary

🔑 BYO Key — Media

Image and video optimization with automatic format conversion, resizing, and CDN delivery. Upload images, apply transformations, and serve optimized versions worldwide. To embed: use https://res.cloudinary.com/{cloud_name}/image/upload/w_800,q_auto,f_auto/{public_id}

🔑 Setup Required — Bring Your Own Key This integration requires API credentials. Store them once via setup_integration or the Dashboard Vault — they're encrypted with AES-256-GCM and never exposed.

Required Credentials

cloudinary_cloud_name

Cloud Name

Find your Cloud Name at cloudinary.com → Dashboard (top-left corner). Example: "dxcfrekzm".

cloudinary_api_key

API Key

Find your API Key at cloudinary.com → Dashboard → API Keys. It's a 15-digit number.

cloudinary_api_secret

API Secret

Find your API Secret at cloudinary.com → Dashboard → API Keys. Click "Reveal" to show it.

Get your API key at cloudinary.com →

Endpoints (4)

POST upload-image

Upload an image to Cloudinary. Provide a URL or base64 data. Returns the optimized CDN URL with automatic format and quality. Optionally apply transformations (resize, crop, effects).

Field	Type	Required	Description
`file`	string	✓ Yes	Image to upload: a public URL (https://...) or base64 data (data:image/png;base64,...)
`public_id`	string	No	Custom filename/ID for the image (without extension). If omitted, Cloudinary generates one.
`folder`	string	No	Folder path to organize the image, e.g. "products" or "blog/headers".
`transformation`	string	No	Eager transformation to apply on upload. Examples: "w_800,h_600,c_fill" (resize+crop), "w_400,q_auto,f_auto" (optimize), "e_blur:300" (blur effect).
`tags`	string	No	Comma-separated tags, e.g. "product,hero,summer2026".
`overwrite`	string	No	"true" to overwrite if public_id already exists. Default: false.

GET get-image

Get details of an uploaded image: dimensions, format, size, URL, and transformations.

Field	Type	Required	Description
`public_id`	string	✓ Yes	The public ID of the image (as returned by upload)

POST delete-image

Delete an image from Cloudinary by its public ID.

Field	Type	Required	Description
`public_ids`	array	✓ Yes	Array of public IDs to delete, e.g. ["products/shirt", "blog/header1"]. Max 100 per call.

GET list-images

List uploaded images. Optionally filter by folder or tag. Returns max 500 per call with cursor pagination.

Field	Type	Required	Description
`prefix`	string	No	Filter by folder/prefix, e.g. "products/" to list all product images.
`max_results`	integer	No	Max results per page (1-500, default 10).
`next_cursor`	string	No	Pagination cursor from previous response.

MCP Tool Names

When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:

Endpoint	MCP Tool Name
upload-image	`cloudinary_upload_image`
get-image	`cloudinary_get_image`
delete-image	`cloudinary_delete_image`
list-images	`cloudinary_list_images`

← Back to all integrations