Cloudinary Environment Config — Claude Code MCP server: setup
The Cloudinary Environment Config MCP server for Claude Code manages Cloudinary environment settings through an AI agent. It handles named transformations, upload presets, and related configuration.
MIT updated 2026-11-16
claude mcp add --transport http environment-config-mcp https://environment-config.mcp.cloudinary.com/mcpWhat Cloudinary Environment Config does
The server connects an AI agent to Cloudinary and exposes tools for account configuration. It can create and update named transformations and upload presets, configure adaptive video streaming profiles, set up webhook triggers, and manage upload folder mappings.
Authentication requires a Cloudinary cloud name, API key, and API secret. A single CLOUDINARY_URL can replace the three separate variables. Running the package through npx requires Node.js 20.19.0 or later; the remote HTTP endpoint is https://environment-config.mcp.cloudinary.com/mcp.
What it helps with
- create a named image transformation
- change a Cloudinary upload preset
- configure an adaptive video streaming profile
- set up a webhook trigger
- manage upload folder mappings
Example prompts for the agent
- List the named transformations in my Cloudinary account.
- Create
t_thumbnailwith the transformation parametersc_fill,w_200,h_200. - Show all upload presets in my account.
How to install Cloudinary Environment Config
1Platform CLI: remote server
claude mcp add --transport http environment-config-mcp https://environment-config.mcp.cloudinary.com/mcp2Platform CLI
claude mcp add --env CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> --env CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> --env CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> --transport stdio cloudinary-environment-config -- npx -y @cloudinary/environment-config-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add cloudinary-environment-config --url https://environment-config.mcp.cloudinary.com/mcp2Platform CLI
codex mcp add cloudinary-environment-config --env CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> --env CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> --env CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> -- npx -y @cloudinary/environment-config-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"cloudinary-environment-config": {
"url": "https://environment-config.mcp.cloudinary.com/mcp"
}
}
}{
"mcpServers": {
"cloudinary-environment-config": {
"command": "npx",
"args": [
"-y",
"@cloudinary/environment-config-mcp"
],
"env": {
"CLOUDINARY_CLOUD_NAME": "<CLOUDINARY_CLOUD_NAME>",
"CLOUDINARY_API_KEY": "<CLOUDINARY_API_KEY>",
"CLOUDINARY_API_SECRET": "<CLOUDINARY_API_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"cloudinary-environment-config": {
"type": "http",
"url": "https://environment-config.mcp.cloudinary.com/mcp"
}
}
}{
"servers": {
"cloudinary-environment-config": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cloudinary/environment-config-mcp"
],
"env": {
"CLOUDINARY_CLOUD_NAME": "<CLOUDINARY_CLOUD_NAME>",
"CLOUDINARY_API_KEY": "<CLOUDINARY_API_KEY>",
"CLOUDINARY_API_SECRET": "<CLOUDINARY_API_SECRET>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http cloudinary-environment-config https://environment-config.mcp.cloudinary.com/mcp2Platform CLI
gemini mcp add -e CLOUDINARY_CLOUD_NAME=<CLOUDINARY_CLOUD_NAME> -e CLOUDINARY_API_KEY=<CLOUDINARY_API_KEY> -e CLOUDINARY_API_SECRET=<CLOUDINARY_API_SECRET> cloudinary-environment-config npx -y @cloudinary/environment-config-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cloudinary Environment Config
How do I install Cloudinary Environment Config in Claude Code?
Register the remote MCP server with claude mcp add --transport http environment-config-mcp https://environment-config.mcp.cloudinary.com/mcp.
What does Cloudinary Environment Config do?
It gives an AI agent tools to manage Cloudinary transformations, upload presets, video streaming profiles, webhook triggers, and upload folder mappings.
What does Cloudinary Environment Config require?
It uses a Cloudinary cloud name, API key, and API secret. Running it through npx also requires Node.js 20.19.0 or later.