Cloudinary Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Cloudinary MCP or direct API to upload media, search and retrieve assets, generate optimized image transformations, and manage folders through natural language.
BOOK A CALLGET STARTED FOR FREE
Cloudinary Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools

Tools
Create FolderTool to create a new asset folder.
Create Metadata FieldTool to create a new metadata field definition.
Create TriggerTool to create a new webhook trigger for a specified event type.
Create Upload MappingTool to create a new upload mapping folder and url template.
Create Upload PresetTool to create a new upload preset.
Delete Derived ResourcesTool to delete derived assets.
Delete Metadata Field Datasource EntriesTool to delete datasource entries for a specified metadata field.
Delete FolderTool to delete an empty asset folder.
Delete Metadata FieldTool to delete a metadata field by external id.
Delete Resources by Asset IDTool to delete resources by asset ids.
Delete Resources by TagsTool to delete cloudinary assets by tag.
Delete TriggerTool to delete a trigger (webhook notification).
Get Adaptive Streaming ProfilesTool to list adaptive streaming profiles.
Get product environment config detailsTool to get product environment config details.
Get Metadata Field By IDTool to get a single metadata field definition by external id.
Get Resource by Asset IDGet resource by asset id
Get Resource by Public IDTool to get details of a single resource by public id.
Get Resources by Asset FolderTool to list assets stored directly in a specified folder.
Get Resources by ContextTool to retrieve assets with a specified contextual metadata key/value.
Get Resources in ModerationTool to retrieve assets in a moderation queue by status.
Get Root FoldersTool to list all root folders in the product environment.
Get Streaming Profile DetailsTool to get details of a single streaming profile by name.
Get Resource TagsTool to list all tags used for a specified resource type.
Get TransformationsTool to list all transformations (named and unnamed).
List Webhook TriggersTool to list all webhook triggers for event types in your environment.
Get Upload Mapping DetailsTool to retrieve details of a single upload mapping by folder.
Get Upload MappingsTool to list all upload mappings by folder.
Get UsageTool to get product environment usage details.
Order Metadata Field DatasourceTool to update ordering of a metadata field datasource.
Ping Cloudinary ServersTool to ping cloudinary servers.
Restore Metadata Field Datasource EntriesTool to restore previously deleted datasource entries for a metadata field.
Search FoldersTool to search asset folders with filtering, sorting, and pagination.
Update FolderTool to rename or move an existing asset folder.
Update Metadata FieldTool to update a metadata field definition by external id.

Connect Cloudinary MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Cloudinary tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a new folder named marketing-assets in Cloudinary')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Cloudinary API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Cloudinary Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a new folder called "2024-campaign-assets" in Cloudinary.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Cloudinary actions with your Agent

Why Use Composio?

AI Native Cloudinary Integration

  • Supports both Cloudinary MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for uploading, searching, and transforming your Cloudinary media

Managed Auth

  • Built-in API key handling with secure storage and rotation
  • Central place to manage, scope, and revoke Cloudinary access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Cloudinary
  • Scoped, least privilege access to Cloudinary resources
  • Full audit trail of agent actions to support review and compliance

Use Cloudinary with any AI Agent Framework

Choose a Framework you want to connect Cloudinary with

Frequently Asked Questions

Do I need my own developer credentials to use Cloudinary with Composio?

Yes, Cloudinary requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Book a call↗Get started for free