# How to integrate Cloudinary MCP with Hermes ```json { "title": "How to integrate Cloudinary MCP with Hermes", "toolkit": "Cloudinary", "toolkit_slug": "cloudinary", "framework": "Hermes", "framework_slug": "hermes-agent", "url": "https://composio.dev/toolkits/cloudinary/framework/hermes-agent", "markdown_url": "https://composio.dev/toolkits/cloudinary/framework/hermes-agent.md", "updated_at": "2026-05-06T08:06:28.847Z" } ``` ## Introduction Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows. This guide explains the easiest and most robust way to connect your Cloudinary account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either. ## Also integrate Cloudinary with - [OpenAI Agents SDK](https://composio.dev/toolkits/cloudinary/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/cloudinary/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/cloudinary/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/cloudinary/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/cloudinary/framework/codex) - [OpenClaw](https://composio.dev/toolkits/cloudinary/framework/openclaw) - [CLI](https://composio.dev/toolkits/cloudinary/framework/cli) - [Google ADK](https://composio.dev/toolkits/cloudinary/framework/google-adk) - [LangChain](https://composio.dev/toolkits/cloudinary/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/cloudinary/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/cloudinary/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/cloudinary/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/cloudinary/framework/crew-ai) ## TL;DR ### What is Composio Connect? Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can: - Search and load tools from relevant toolkits on-demand, reducing context usage. - Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM. - Manage app authentication end-to-end with zero manual overhead. ## Connect Cloudinary to Hermes ### Integrating Cloudinary with Hermes ### Using Composio Connect CLI 1. Install the Composio CLI Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you. ```bash curl -fsSL https://composio.dev/install | bash ``` ## What is the Cloudinary MCP server, 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. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `CLOUDINARY_CREATE_FOLDER` | Create Folder | Tool to create a new asset folder. use when you need to organize assets into nested directories. use after confirming the folder path does not already exist. | | `CLOUDINARY_CREATE_METADATA_FIELD` | Create Metadata Field | Tool to create a new metadata field definition. use when extending your metadata schema with new fields. | | `CLOUDINARY_CREATE_TRIGGER` | Create Trigger | Tool to create a new webhook trigger for a specified event type. use after configuring your webhook endpoint and choosing the event type. example: "create a trigger for uploads to https://example.com/hooks/cloudinary" | | `CLOUDINARY_CREATE_UPLOAD_MAPPING` | Create Upload Mapping | Tool to create a new upload mapping folder and url template. use when you need to dynamically map external url prefixes to a cloudinary asset folder before uploading files. | | `CLOUDINARY_CREATE_UPLOAD_PRESET` | Create Upload Preset | Tool to create a new upload preset. use when defining centralized upload options (tags, formats, transformations, etc.) before asset uploads. | | `CLOUDINARY_DELETE_DERIVED_RESOURCES` | Delete Derived Resources | Tool to delete derived assets. use when you need to remove specific derived assets by their ids. example: "delete derived assets with ids [id1, id2]". | | `CLOUDINARY_DELETE_ENTRIES_IN_METADATA_FIELD_DATASOURCE` | Delete Metadata Field Datasource Entries | Tool to delete datasource entries for a specified metadata field. use when you need to soft-delete (inactivate) specific entries in a field's datasource. example prompt: "delete entries ['color1','color2'] from metadata field 'color id'" | | `CLOUDINARY_DELETE_FOLDER` | Delete Folder | Tool to delete an empty asset folder. use when the folder is confirmed empty and you need to remove it. | | `CLOUDINARY_DELETE_METADATA_FIELD` | Delete Metadata Field | Tool to delete a metadata field by external id. use when you need to remove a metadata field that is no longer required. | | `CLOUDINARY_DELETE_RESOURCES_BY_ASSET_ID` | Delete Resources by Asset ID | Tool to delete resources by asset ids. use when you need to permanently remove specific resources by their immutable asset ids; irreversible. | | `CLOUDINARY_DELETE_RESOURCES_BY_TAGS` | Delete Resources by Tags | Tool to delete cloudinary assets by tag. use when you need to remove all assets associated with a given tag. | | `CLOUDINARY_DELETE_TRIGGER` | Delete Trigger | Tool to delete a trigger (webhook notification). use when you need to remove a trigger by its id after confirming the correct id. | | `CLOUDINARY_GET_ADAPTIVE_STREAMING_PROFILES` | Get Adaptive Streaming Profiles | Tool to list adaptive streaming profiles. use when retrieving built-in and custom adaptive streaming profiles for delivering video via hls or dash. | | `CLOUDINARY_GET_CONFIG` | Get product environment config details | Tool to get product environment config details. use when you need to fetch or verify environment configuration such as folder mode. | | `CLOUDINARY_GET_METADATA_FIELD_BY_ID` | Get Metadata Field By ID | Tool to get a single metadata field definition by external id. use after creating or updating a metadata field to fetch its full definition. example: "get metadata field definition for external id 'color id'." | | `CLOUDINARY_GET_RESOURCE_BY_ASSET_ID` | Get Resource by Asset ID | Get resource by asset id | | `CLOUDINARY_GET_RESOURCE_BY_PUBLIC_ID` | Get Resource by Public ID | Tool to get details of a single resource by public id. use when you need full asset, derived, and related info. | | `CLOUDINARY_GET_RESOURCES_BY_ASSET_FOLDER` | Get Resources by Asset Folder | Tool to list assets stored directly in a specified folder. use when you need to view assets in a specific folder without including subfolder contents. | | `CLOUDINARY_GET_RESOURCES_BY_CONTEXT` | Get Resources by Context | Tool to retrieve assets with a specified contextual metadata key/value. use when filtering resources by context metadata. | | `CLOUDINARY_GET_RESOURCES_IN_MODERATION` | Get Resources in Moderation | Tool to retrieve assets in a moderation queue by status. use after moderation to process pending or reviewed assets. | | `CLOUDINARY_GET_ROOT_FOLDERS` | Get Root Folders | Tool to list all root folders in the product environment. use when you need to retrieve top-level asset folders. | | `CLOUDINARY_GET_STREAMING_PROFILE_DETAILS` | Get Streaming Profile Details | Tool to get details of a single streaming profile by name. use when you need to inspect an existing profile's configuration before making changes. example: "get details of streaming profile 'hd'." | | `CLOUDINARY_GET_TAGS` | Get Resource Tags | Tool to list all tags used for a specified resource type. use when you need to retrieve or page through the tags assigned to your assets. | | `CLOUDINARY_GET_TRANSFORMATIONS` | Get Transformations | Tool to list all transformations (named and unnamed). use when you need to retrieve transformation definitions or paginate through transformation records. | | `CLOUDINARY_GET_TRIGGERS` | List Webhook Triggers | Tool to list all webhook triggers for event types in your environment. use when you need to retrieve or filter existing triggers by type. | | `CLOUDINARY_GET_UPLOAD_MAPPING_DETAILS` | Get Upload Mapping Details | Tool to retrieve details of a single upload mapping by folder. use when you need the url prefix template associated with a specific mapping folder. | | `CLOUDINARY_GET_UPLOAD_MAPPINGS` | Get Upload Mappings | Tool to list all upload mappings by folder. use when you need to retrieve and paginate through upload mapping configurations, optionally filtering by folder. | | `CLOUDINARY_GET_USAGE` | Get Usage | Tool to get product environment usage details. use when you need to monitor your cloudinary account storage, bandwidth, requests, and other usage limits. | | `CLOUDINARY_ORDER_METADATA_FIELD_DATASOURCE` | Order Metadata Field Datasource | Tool to update ordering of a metadata field datasource. use when you need to reorder enum or set values for a metadata field datasource before updating assets. | | `CLOUDINARY_PING_CLOUDINARY_SERVERS` | Ping Cloudinary Servers | Tool to ping cloudinary servers. use when testing api reachability and authentication. | | `CLOUDINARY_RESTORE_ENTRIES_IN_METADATA_FIELD_DATASOURCE` | Restore Metadata Field Datasource Entries | Tool to restore previously deleted datasource entries for a metadata field. use after deleting entries to reactivate soft-deleted datasource entries. | | `CLOUDINARY_SEARCH_FOLDERS` | Search Folders | Tool to search asset folders with filtering, sorting, and pagination. use when you need to locate specific folders by name, path, or creation date. | | `CLOUDINARY_UPDATE_FOLDER` | Update Folder | Tool to rename or move an existing asset folder. use when you need to change the folder's name or location. | | `CLOUDINARY_UPDATE_METADATA_FIELD` | Update Metadata Field | Tool to update a metadata field definition by external id. use when modifying an existing schema field (e.g., changing label or validation) without redefining all properties. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Cloudinary MCP server provides comprehensive access to Cloudinary operations through Composio. Once connected, Hermes can perform all major Cloudinary actions on your behalf using natural language commands. ## Complete Code None listed. ## Conclusion ### Way Forward With Cloudinary connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to. From here, you can extend Hermes further: - Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you. - Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft. - Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt. If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options. ## How to build Cloudinary MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/cloudinary/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/cloudinary/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/cloudinary/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/cloudinary/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/cloudinary/framework/codex) - [OpenClaw](https://composio.dev/toolkits/cloudinary/framework/openclaw) - [CLI](https://composio.dev/toolkits/cloudinary/framework/cli) - [Google ADK](https://composio.dev/toolkits/cloudinary/framework/google-adk) - [LangChain](https://composio.dev/toolkits/cloudinary/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/cloudinary/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/cloudinary/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/cloudinary/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/cloudinary/framework/crew-ai) ## Related Toolkits - [Figma](https://composio.dev/toolkits/figma) - Figma is a collaborative interface design tool for teams and individuals. It streamlines design workflows with real-time collaboration and easy sharing. - [Abyssale](https://composio.dev/toolkits/abyssale) - Abyssale is a creative automation platform for generating images, videos, GIFs, PDFs, and HTML5 content programmatically. It streamlines and scales visual content production for marketing, design, and operations teams. - [Alttext ai](https://composio.dev/toolkits/alttext_ai) - AltText.ai is a service that generates alt text for images automatically. It helps boost accessibility and SEO for your visual content. - [Bannerbear](https://composio.dev/toolkits/bannerbear) - Bannerbear is an API-driven platform for generating images and videos automatically at scale. It helps businesses create custom graphics, social visuals, and marketing assets using powerful templates. - [Canva](https://composio.dev/toolkits/canva) - Canva is a drag-and-drop design suite for creating professional graphics, presentations, and marketing materials. It makes it easy for anyone to design with beautiful templates and a vast library of elements. - [Claid ai](https://composio.dev/toolkits/claid_ai) - Claid.ai delivers AI-driven image editing APIs for tasks like background removal, upscaling, and color correction. It helps automate and enhance image workflows with powerful, developer-friendly tools. - [Cults](https://composio.dev/toolkits/cults) - Cults is a digital marketplace for 3D printing models, connecting designers and makers. It lets creators share, sell, and discover a huge variety of printable designs easily. - [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks. - [Dreamstudio](https://composio.dev/toolkits/dreamstudio) - DreamStudio is Stability AI’s platform for generating and editing images with AI. It lets you easily turn ideas into stunning visuals, fast. - [Fal.ai](https://composio.dev/toolkits/fal_ai) - Fal.ai is a generative media platform offering 600+ AI models for images, video, voice, and audio. Developers use Fal.ai for fast, scalable access to cutting-edge generative AI tools. - [Html to image](https://composio.dev/toolkits/html_to_image) - Html to image converts HTML and CSS into images or captures web page screenshots. Instantly generate visuals from code or web content—no manual screenshots needed. - [Imagior](https://composio.dev/toolkits/imagior) - Imagior is an AI-powered image generation platform that lets you create and customize images using dynamic templates and APIs. Perfect for businesses and creators needing fast, scalable visuals without design hassle. - [Imejis io](https://composio.dev/toolkits/imejis_io) - Imejis io is an API-based image generation platform with powerful customization and template support. It lets you create and modify images in seconds, no manual design work required. - [Imgix](https://composio.dev/toolkits/imgix) - Imgix is a real-time image processing and delivery service for developers. It helps you optimize, transform, and deliver images efficiently at any scale. - [Kraken io](https://composio.dev/toolkits/kraken_io) - Kraken.io is an image optimization and compression platform. It helps you shrink image file sizes while keeping visual quality intact. - [Logo dev](https://composio.dev/toolkits/logo_dev) - Logo.dev is an API and database for high-resolution company logos and brand metadata. Instantly fetch official logos from any domain without scraping or manual searching. - [Miro](https://composio.dev/toolkits/miro) - Miro is a collaborative online whiteboard platform for teams to brainstorm, design, and manage projects visually. It streamlines teamwork by enabling real-time idea sharing, diagramming, and workflow planning in a single space. - [Mural](https://composio.dev/toolkits/mural) - Mural is a digital whiteboard platform for distributed visual collaboration. It helps teams brainstorm, map ideas, and diagram together in real time. - [Pexels](https://composio.dev/toolkits/pexels) - Pexels is a free stock library offering high-quality photos and videos via API. Instantly boost your app or website with stunning visuals for any use case. - [Placid](https://composio.dev/toolkits/placid) - Placid is a creative automation toolkit that generates images, PDFs, and videos from custom templates via API. Effortlessly automate creative workflows and dynamic content creation at scale. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Cloudinary MCP? 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. ### Can I use Tool Router MCP with Hermes? Yes, you can. Hermes 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. ### Can I manage the permissions and scopes for Cloudinary while using Tool Router? 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. ### How safe is my data with Composio Tool Router? 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. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)