---
title: "Announcing Medusa Cloud CLI"
description: "Introducing @medusajs/mcloud, the official Medusa Cloud CLI. Authenticate, manage projects and environments, trigger deployments, and stream logs from your terminal."
url: https://medusajs.com/blog/announcing-medusa-cloud-cli
last_updated: 2026-08-13T14:34:05Z
---

# Announcing Medusa Cloud CLI

_Published 2026-05-12 by Christian Anese in Product_

Today we're shipping `@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:

```bash
npm install -g @medusajs/mcloud
```

Authentication supports two flows. Run `mcloud 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 `mcloud use`

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

Run `mcloud 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

`mcloud` 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.

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

## Stream runtime logs with `mcloud logs`

`mcloud 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:

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

## Get started

`@medusajs/mcloud` is available now on npm. Install it, run `mcloud login`, and start managing your Medusa Cloud projects from the terminal. Full command reference is in [the Medusa Cloud docs](https://docs.medusajs.com/cloud).