Meshy CLI

Meshy from the command line

One command turns a prompt or an image into a finished, textured model.

Install meshy-cliView on GitHub
terminal — meshy
$ meshy make "girl with a pearl earring, painted bust" --dry-run
Plan 2 steps · ~30 credits
1. text-to-3d preview ~20
2. text-to-3d refine ~10
Estimates only — confirm prices at https://docs.meshy.ai/en/api/pricing and your balance with `meshy balance`.
$ meshy make "girl with a pearl earring, painted bust" -o pearl.glb
✓ [1/2] text-to-3d preview (geometry)
✓ [2/2] text-to-3d refine (textures)
✓ SUCCEEDED text-to-3d-refine
Assets glb · textures: base_color, metallic, normal, roughness · thumbnail
Saved pearl.glb

Install meshy-cli

Requires Node.js 22.12 or later. Install the CLI, sign in, and start creating from your terminal.

~/your-project

bash

$ npm install -g meshy-cli

Browser login

Sign in once in the browser instead of pasting an API key into every environment you work in.

meshy auth login

Readable for people, ready for agents

Readable output in your terminal. Structured JSON when piped or requested with --json, with distinct exit codes for automation.

--json

Scriptable without an agent

Turn a prompt or an image into a textured model with meshy make. Add -o to save the result locally.

meshy make

Let your agent take over Meshy CLI

Copy this prompt into your coding agent to get started.

text

Help me install Meshy CLI and the meshy-3d-agent skill:
https://raw.githubusercontent.com/meshy-dev/meshy-3d-agent/main/INSTALL.md

Using ChatGPT (Codex) Desktop?

Open Plugins, search for Meshy, and install the Meshy plugin.

Coming soon

Meshy is coming to the official marketplaces for Claude Desktop, Muse, and more. You can already install Meshy by sending the prompt above to your agent.

Also available in ClawHub and Hermes Skills Hub. Search for Meshy.

Get for OpenClawGet for Hermes Agent

For MCP users

Connect your agent through the Meshy MCP server.

MCP setup guide

Frequently asked questions

Yes. With Node.js 22.12 or later, run npm install -g meshy-cli, then meshy auth login to sign in through your browser.

Use generation, post-processing, downloads and local workflow commands. meshy make chains the documented text or image flow; endpoint commands and meshy api provide more control. CLI and MCP capabilities evolve independently.

No. Sign-in opens your browser once — an OAuth flow, with no key created or pasted into a shell profile. An API key is still accepted as an override for CI. The MCP server available today does use an API key.

Yes. Alongside the browser flow there is a device-code path for headless machines — the CLI prints a link and a short code to approve from any other device — plus a manual paste-back fallback.

Humans, scripts and AI agents can call the CLI. MCP clients call the separately installed MCP server. Both call the Meshy REST API; the CLI does not run through or require MCP.

meshy-cli is developed in the open in the Meshy GitHub organisation, alongside the MCP server.

Explore More Features

3D Agent

3D Agent

Chat from an idea, photo, or sketch to a print-ready 3D model

Image to 3D

Image to 3D

Turn any photo into a detailed 3D model in seconds

Text to 3D

Text to 3D

Describe it, generate it - 3D models from text prompts

AI Texturing

AI Texturing

Add realistic PBR textures to any 3D model with AI

AI Image Generator

AI Image Generator

Generate multi-view images optimized for 3D creation

Animation

Animation

Auto-rig and animate any 3D character in seconds

Put Meshy in your terminal

Install meshy-cli, then sign in through your browser or configure an API key for automation.

Install meshy-cli