
Meshy MCP Server: Generate 3D Models and Images From Your Assistant
Lets your assistant make 3D models, textures, animations and print-ready files with Meshy.
Meshy's own server lets Claude, Cursor and other assistants create 3D models from text or pictures, texture and rig them, and prepare files for 3D printing. It runs on your computer and talks to the Meshy API.
You need a Meshy API key, and the README says the API requires a Pro plan or above. Most generation tools spend credits from your Meshy balance, so ask the assistant to tell you the cost and wait for your approval before it runs.
Good for
- 3D artists and game developers who want quick models and rigs
- Makers who print figures, lamps and keychains from photos
- Developers adding 3D generation to an agent
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install meshy-mcp-server
Claude Code
- 1
Copy this prompt.
Add the meshy-mcp-server server to Claude Code. Run this command: claude mcp add meshy -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @meshy-ai/meshy-mcp-server Ask me for MESHY_API_KEY and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Built from the package data we hold. Not yet tested by us.
Tools
Makes an untextured 3D model from a text prompt
Creates a 3D preview from a description in about 2 to 3 minutes. It costs 20 credits on the newest models, and you texture it afterwards once you approve.
Try: “Generate a 3D preview of a low-poly fox.”
Write ·
meshy_text_to_3dAdds textures to a text-to-3D preview
Textures a preview that has finished. It costs 10 credits, or 15 at 8K, so the assistant should ask you first.
Try: “Texture the fox preview with a red fur look.”
Write ·
meshy_text_to_3d_refineTurns one picture into a 3D model
Builds a model from a single image, textured by default. On the newest models it costs 20 credits for a bare mesh and 30 textured.
Try: “Make a 3D model from this product photo.”
Write ·
meshy_image_to_3dTurns 1 to 4 pictures of an object into a 3D model
Uses several views of the same object for a better reconstruction, textured by default, at the same credit cost as a single image.
Try: “Build a 3D model from these front, side and back photos.”
Write ·
meshy_multi_image_to_3dMakes a 2D image from text
Generates a picture, for example a design to approve before going to 3D. It takes about 30 seconds and costs 3 to 12 credits depending on the image model.
Try: “Draw a concept image of a robot mascot.”
Write ·
meshy_text_to_imageEdits or restyles an image from a prompt
Changes an existing image using a text instruction and one reference source. It costs the same credits as text to image.
Try: “Restyle this sketch as a clay render.”
Write ·
meshy_image_to_imageTurns a photo into a print-ready product model
Takes a photo and builds a finished product model such as a figure, lamp or keychain from start to finish. Each product costs credits, from 6 up to 62, so confirm before it runs.
Try: “Turn this photo into a keychain with the name Sam.”
Write ·
meshy_creative_labChanges a model's polygon count or layout
Remeshes an existing model for 5 credits. For a format change alone the convert tool is cheaper.
Try: “Remesh the fox to 5,000 faces.”
Write ·
meshy_remeshGives a model new AI textures
Applies a new texture from a text style or a reference image for 10 credits, or 15 at 8K.
Try: “Retexture the fox as rusty metal.”
Write ·
meshy_retextureAdds a skeleton to a humanoid model
Auto-rigs a textured humanoid for 5 credits and returns free walking and running animations as separate files.
Try: “Rig the knight model.”
Write ·
meshy_rigApplies an animation to a rigged character
Animates a rigged model for 3 credits per action, using an action from the animation library or a motion clip.
Try: “Make the knight do a victory dance.”
Write ·
meshy_animateCreates a motion clip from a description
Generates a motion clip from text for 10 credits (prime) or 3 credits (swift), then you can apply it to a rigged character.
Try: “Create a motion of a character waving.”
Write ·
meshy_text_to_motionSearches the preset animation library
Looks up the animation IDs that the animate tool accepts. It is free and can be filtered by name or category.
Try: “Find dance animations.”
Network ·
meshy_list_animationsConverts a model to other file formats
Exports a finished model to formats such as STL or 3MF for 1 credit.
Try: “Convert the fox to STL and 3MF.”
Write ·
meshy_convertScales a model to real-world size
Rescales a model on Meshy to a height or longest side you give, for 1 credit.
Try: “Resize the figure to 8 cm tall.”
Write ·
meshy_resizeMakes a clean UV layout for outside texturing
Creates a non-overlapping UV layout for 5 credits, for texturing in Blender or Substance Painter. GLB input only.
Try: “UV-unwrap the knight for texturing in Blender.”
Write ·
meshy_uv_unwrapChecks whether a model can be 3D printed
Looks for holes, non-manifold edges and, if you give a printer type, thin walls. The README says it is free.
Try: “Is this model printable on a resin printer?”
Network ·
meshy_analyze_printabilityRepairs a model for 3D printing
Fixes holes and bad edges to make the model watertight for 10 credits. Textures are removed.
Try: “Repair the figure so it prints.”
Write ·
meshy_repair_printabilityPrepares a multi-color 3MF for a printer
Turns a textured model into a multi-color 3MF ready for the slicer of your printer brand, for 10 credits.
Try: “Make a 4-color 3MF for my Bambu printer.”
Write ·
meshy_process_multicolorCuts a model into printable parts
Splits a model into parts that fit the print bed or take different colors, with optional connectors. The texture is not kept.
Try: “Split the statue into parts for my printer.”
Write ·
meshy_auto_splitFinds your slicers and how to open them
Detects installed 3D printing slicers and returns the commands that launch them with a file. On Linux it runs a which lookup to find them; it does not launch anything.
Try: “Which slicers do I have installed?”
Runs code ·
meshy_send_to_slicerWaits for a task or checks its status
Waits for a job to finish or checks it once, and reports the task type needed by the download and cancel tools.
Try: “Is my fox model done?”
Network ·
meshy_get_task_statusLists your recent jobs
Lists tasks of any status, newest first, across the generation task types.
Try: “Show my last 10 Meshy jobs.”
Network ·
meshy_list_tasksLists your finished 3D models
Lists finished models with the task ID and the formats ready to download.
Try: “What models have I finished?”
Network ·
meshy_list_modelsSaves a finished result to your computer
Downloads a finished task's output into a meshy_output folder or a path you give. For 3D models it saves one format of your choice.
Try: “Download the fox as GLB.”
Write ·
meshy_download_modelCancels a queued job or deletes a finished one
Cancels a queued task, which can refund credits, or deletes a finished one. The effect depends on the task type.
Try: “Cancel the queued Creative Lab job.”
Delete ·
meshy_cancel_taskShows your credit balance
Returns your remaining Meshy credits. For team members this is the team's shared pool. It is free.
Try: “How many Meshy credits do I have left?”
Network ·
meshy_check_balanceBreaks down credit use by finished job
Lists finished API tasks with the credits each used. It only works for API keys on a Studio or Enterprise team.
Try: “Where did my credits go this month?”
Network ·
meshy_list_usage
Read from the source code
Permissions
high risk · 4 things to watch
High risk
The assistant can spend your Meshy credits on every generation, rigging and print-prep call, and it can cancel or delete tasks. Ask it to state the credit cost and wait for your OK before each paid action.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It spends your Meshy credits
Most tools charge credits, for example 20 to 30 for a model, 36 or more for a Creative Lab product and up to 62 for a keycap. Ask for the cost first and watch your balance. github.com
It can cancel and delete tasks
meshy_cancel_task cancels a queued task, which can refund credits, or deletes a finished one. Check what the assistant is about to remove. github.com
It writes files to your computer
meshy_download_model saves outputs under a meshy_output folder or a path you give. Pick the folder yourself. github.com
Your photos and prompts go to Meshy
Images and prompts you use are sent to the Meshy API for processing. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. Free tools such as the balance check only read, but generation tools spend credits. |
|---|---|
| Talks to | api.meshy.ai (Meshy API) |
| Sign-in and keys | MESHY_API_KEY in your MCP config. Downloaded models are saved to a meshy_output folder or the path you give. |
Questions
Is the Meshy MCP server official?
Yes. Meshy publishes it under its own organization and it connects to the Meshy API.
Do I need a paid Meshy plan?
The README says the API key requires a Pro plan or above. Each tool call then spends credits from your balance.
How much does a 3D model cost?
On the newest models, a text-to-3D preview costs 20 credits, texturing it costs 10, and image-to-3D costs 20 for a bare mesh or 30 textured. Other tools cost 1 to 62 credits per the README.
Can I check my credits from the assistant?
Yes. The balance tool is free, and a usage tool lists spend per finished task for Studio and Enterprise teams.
Can I use it for 3D printing?
Yes. It can check a model for printability, repair it, make a multi-color 3MF, split it into parts and find your installed slicers. Repair and multi-color cost 10 credits each.
Does it need an API key?
Yes. Get a key from your Meshy account. It starts with msy_ and goes in the MESHY_API_KEY setting of your MCP config.
How do I add it to Claude Desktop or Cursor?
Use the install box above and put your API key in the placeholder. Restart the app so it loads the tools.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@meshy-ai/meshy-mcp-server- Registry
- npm
- Transport
- stdio
- Auth
- API key
- Version
- 0.6.7
- License
- MIT
- Last commit
- Oct 30, 2026
- Open issues
- 3
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- www.npmjs.com · npmjs.com