# Cloudinary Environment Config

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: cloudinary
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cloudinary/environment-config-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/cloudinary-environment-config

## What it 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`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://environment-config.mcp.cloudinary.com/mcp`
- Environment variables: `CLOUDINARY_CLOUD_NAME`, `CLOUDINARY_API_KEY`, `CLOUDINARY_API_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http environment-config-mcp https://environment-config.mcp.cloudinary.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add cloudinary-environment-config --url https://environment-config.mcp.cloudinary.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cloudinary-environment-config": {
            "url": "https://environment-config.mcp.cloudinary.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cloudinary-environment-config": {
            "type": "http",
            "url": "https://environment-config.mcp.cloudinary.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http cloudinary-environment-config https://environment-config.mcp.cloudinary.com/mcp
```

2. **Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- List the named transformations in my Cloudinary account.
- Create `t_thumbnail` with the transformation parameters `c_fill,w_200,h_200`.
- Show all upload presets in my account.

## Similar
- [cloudinary-docs](https://affpapa.org/en/nevibecode/skills/cloudinary-docs.md) — skill · 1100 installs
- [cloudinary-transformations](https://affpapa.org/en/nevibecode/skills/cloudinary-transformations.md) — skill · 906 installs
- [market-environment-analysis](https://affpapa.org/en/nevibecode/skills/market-environment-analysis.md) — skill · 4300 installs
- [platform-environment-validate](https://affpapa.org/en/nevibecode/skills/platform-environment-validate.md) — skill · 2800 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
