# Cloudinary Shell MCP server

> Provides a Unix-style shell, scriptable CLI, and MCP server to manage Cloudinary assets like a local file system.

- Repository: https://github.com/Sheldon1999/cldsh-Cloudinary-Shell
- Page: https://hostedmcp.org/servers/sheldon1999/cldsh-cloudinary-shell
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 2.0.1

## Install

### Claude Code

```sh
claude mcp add cldsh-cloudinary-shell -- npx -y cloudinary-shell
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "cldsh-cloudinary-shell": {
      "command": "npx",
      "args": [
        "-y",
        "cloudinary-shell"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "cldsh-cloudinary-shell": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cloudinary-shell"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"cldsh-cloudinary-shell","type":"stdio","command":"npx","args":["-y","cloudinary-shell"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "cldsh-cloudinary-shell": {
      "command": "npx",
      "args": [
        "-y",
        "cloudinary-shell"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add cldsh-cloudinary-shell -- npx -y cloudinary-shell
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.cldsh-cloudinary-shell]
command = "npx"
args = ["-y", "cloudinary-shell"]
```

### Gemini CLI

```sh
gemini mcp add -s user cldsh-cloudinary-shell npx -- -y cloudinary-shell
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "cldsh-cloudinary-shell": {
      "command": "npx",
      "args": [
        "-y",
        "cloudinary-shell"
      ]
    }
  }
}
```

## Tools (11)

- `cloudinary_list`
- `cloudinary_tree`
- `cloudinary_info`
- `cloudinary_get_url`
- `cloudinary_upload`
- `cloudinary_download`
- `cloudinary_move`
- `cloudinary_delete`
- `cloudinary_mkdir`
- `cloudinary_rename_folder`
- `cloudinary_account`

## FAQ

### Does it support both Cloudinary folder modes?

Yes, it automatically detects whether your account uses dynamic folders or the older fixed folders.

### Is there a safety mechanism for destructive actions?

Yes, destructive tools like delete or move return a preview with a confirmation token that must be used to finalize the change.

### Can I use it for automated scripts?

Yes, it offers a scriptable CLI with JSON output and meaningful exit codes for CI/CD integration.