Announcing Medusa Cloud CLI

Today we're shipping Copy to clipboard@medusajs/mcloud, the official CLI for Medusa Cloud. It puts your cloud environment one command away: build logs, runtime logs, deployment context, and the rest of your resources, accessible from the terminal without ever opening the dashboard.

Drop it into Claude Code, Codex, Cursor, or any coding harness, and your agent has live operational context from Medusa Cloud while you build your store.

Install and authenticate

Install the CLI from npm:

1
npm install -g @medusajs/mcloud

Authentication supports two flows. Run Copy to clipboardmcloud login to open a browser-based OAuth flow, or pass a token directly if you're working in CI or a headless environment. Either way, credentials are stored locally so subsequent commands work without re-authenticating.

Set a persistent context with Copy to clipboardmcloud use

Most cloud CLIs require you to repeat flags like Copy to clipboard--org, Copy to clipboard--project, and Copy to clipboard--env on every command. Copy to clipboardmcloud use eliminates that.

Run Copy to clipboardmcloud use once to select your organization, project, and environment. That context is persisted locally and applied automatically to every subsequent command. You can switch contexts at any time by running it again.

Manage organizations, projects, and environments

Copy to clipboardmcloud covers the full resource hierarchy you work with in Medusa Cloud:

• List and inspect organizations
• Create, list, and inspect projects
• Create, list, and switch between environments
• Manage environment variables per environment

This means provisioning a new environment or updating a variable is a single command, scriptable and repeatable.

Trigger and monitor deployments

You can kick off builds and redeploys from the CLI without navigating to a dashboard.

• Copy to clipboardmcloud deploy triggers a new deployment for the active project and environment
• Copy to clipboardmcloud redeploy reruns the last successful build
• Deployment status is surfaced inline so you know when a build completes or fails

Stream runtime logs with Copy to clipboardmcloud logs

Copy to clipboardmcloud logs --follow streams live runtime logs directly to your terminal. This is useful for debugging deployments or monitoring running services without switching to a UI.

The command supports several filters to narrow output:

• Copy to clipboard--search to match log lines by keyword
• Copy to clipboard--source to filter by log source (e.g., server, worker)
• Metadata filters to scope logs to specific instances or contexts

Get started

Copy to clipboard@medusajs/mcloud is available now on npm. Install it, run Copy to clipboardmcloud login, and start managing your Medusa Cloud projects from the terminal. Full command reference is in the Medusa Cloud docs.