cloudinary

This Cloudinary MCP Server provides a dedicated tool named upload that lets Claude Desktop and compatible MCP clients send images and videos directly to Cloudinary. The server acts as a bridge between your MCP client and Cloudinary, handling file transmission, choosing the Cloudinary resource type (image, video, or raw), and applying optional metadata like public_id and tags. The available tool, upload, accepts a file parameter along with optional resource_type, public_id, overwrite, and tags to customize the upload. To use it, configure the MCP server in Claude’s settings, then call the upload tool from your client with the appropriate arguments. The server uses your Cloudinary credentials via environment variables to authorize uploads securely.

Prerequisites:

• Node.js (version 18 or higher) and npm installed on your system
• Access to Claude with MCP configuration capability

Install steps:

1. Ensure Node.js and npm are installed:

   • Verify: node --version
   • Verify: npm --version

2. Install or run via npx (recommended) by configuring Claude’s MCP settings:

   • In Claude, add the MCP server configuration using the following:

     { "mcpServers": { "cloudinary": { "command": "npx", "args": ["@felores/cloudinary-mcp-server@latest"], "env": { "CLOUDINARY_CLOUD_NAME": "your_cloud_name", "CLOUDINARY_API_KEY": "your_api_key", "CLOUDINARY_API_SECRET": "your_api_secret" } } } }

3. If you prefer to develop or modify locally:

   • Clone the repository (if available): git clone https://github.com/felores/cloudinary-mcp-server.git cd cloudinary-mcp-server
   • Install dependencies and build: npm install npm run build

4. Start or reference the server through npx in Claude as shown above.

Environment variables CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, and CLOUDINARY_API_SECRET must be set with valid Cloudinary credentials for uploads to succeed. If you encounter authentication or permission errors, verify your API keys and Cloudinary account permissions. The upload tool supports resource_type to specify 'image', 'video', or 'raw'; omit resource_type to use default behavior. You can provide a public_id to customize the Cloudinary asset name and tags to attach metadata. When using Claude/Cline MCP, ensure the MCP configuration file is kept secure and not exposed publicly, since it contains API credentials.