cloudinary-init
v0.1.1
Published
One command to connect Cloudinary MCP servers and skills to your AI coding environment (demo by @ryaron)
Maintainers
Readme
@cloudinary/init
One command to connect Cloudinary to your AI coding environment.
npx @cloudinary/initOr with your credentials pre-set:
CLOUDINARY_URL=cloudinary://api_key:api_secret@cloud_name npx @cloudinary/initWhat it does
- Credentials — reads your
CLOUDINARY_URLfrom the environment, or prompts you to paste it. No CLOUDINARY_URL? Press Enter to use OAuth (browser-based) instead. - IDE detection — finds Cursor, Claude Code, Claude Desktop, VS Code, and Windsurf automatically.
- MCP configuration — writes all four Cloudinary MCP servers into the config file of every detected IDE.
- Skills installation — runs
npx skills add cloudinary-devs/skillsto install doc, transformation, and React skills. - Quick start guide — creates
CLOUDINARY_QUICKSTART.mdin your current directory with your first 3 agent prompts.
Supported IDEs
| IDE | Config file written |
|-----|-------------------|
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| VS Code (workspace) | .vscode/mcp.json in current directory |
| Claude Code | claude mcp add CLI commands |
MCP servers configured
| Server | Capability |
|--------|-----------|
| cloudinary-asset-mgmt | Upload, search, organize, transform assets |
| cloudinary-env-config | Upload presets, named transformations, webhooks |
| cloudinary-smd | Structured metadata fields and values |
| cloudinary-analysis | AI tagging, moderation, object detection (OAuth only) |
Authentication
API key (recommended for agents): Paste your CLOUDINARY_URL from Console Settings → API Keys. Format: cloudinary://api_key:api_secret@cloud_name.
OAuth: Leave the URL blank. After setup, open your IDE and click "Connect" next to any Cloudinary MCP server to authenticate via browser.
Note:
cloudinary-analysisrequires OAuth regardless of auth method.
Requirements
- Node.js 18+
- A Cloudinary account (sign up free)
What to do after setup
Open your AI agent and try:
- "Upload this image to my Cloudinary cloud: https://res.cloudinary.com/demo/image/upload/sample.jpg"
- "Give me an optimized delivery URL for the sample image using f_auto and q_auto"
- "Search my assets and list the 5 most recent uploads"
See CLOUDINARY_QUICKSTART.md in your project for a full first-use guide.
