How do I install the Bambu skill?

Run npx skillmds@latest add dvcrn/bambu in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bambu safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bambu?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bambu free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bambu by dvcrn — Agent Skill

Name: Bambu
Rating: 4.2 (5 reviews)
Author: dvcrn

Bambu

Control Bambu Lab 3D printers (H2D, X1C, P1S, A1) via CLI. Print management, AMS filament control, temperature, fans, lights, calibration, file management, and live monitoring. Use when operating a 3D printer, starting prints, monitoring progress, managing filaments, or troubleshooting printer issues.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Bambu Lab 3D Printer Control

Full control of Bambu Lab printers via MQTT + FTP. Agent-agnostic, local-only, no cloud.

Prerequisites

Printer must be in Developer Mode (Settings → LAN Only → Enable Developer Mode)
Need: IP address, serial number, LAN access code (from printer touchscreen)
CLI: @versatly/bambu installed globally (npm i -g @versatly/bambu)

Setup

bambu setup <ip> <serial> <access_code>
bambu ping  # verify connection

Config stored at ~/.bambu/config.json.

Progressive Loading Guide

Load ONLY what you need for the current task:

Level 1: Status Check (most common)

bambu status          # full status overview
bambu status --json   # programmatic access
bambu temp            # just temperatures  
bambu ams             # just AMS/filament info
bambu errors          # any active errors

Level 2: Print Operations

# Start a print from SD card
bambu print "filename.3mf"

# Upload and print in one step
bambu job upload-and-print ./my-part.3mf

# Control running print
bambu pause
bambu resume  
bambu stop

# Live monitoring (streams progress)
bambu watch

Level 3: Hardware Control

# Temperature
bambu heat nozzle:220 bed:60
bambu cooldown

# Fans (0-100%)
bambu fan part 80
bambu fan aux 50
bambu fan chamber 30

# Lights
bambu light on
bambu light off

# Movement
bambu home
bambu move x:10 y:20 z:5
bambu gcode "G28"

Level 4: AMS Filament Management

# Check what's loaded
bambu ams

# Load specific tray (0-3)
bambu load 0
bambu load 2

# Unload current filament
bambu unload

Level 5: File Management & Calibration

# SD card files
bambu files
bambu upload ./part.3mf
bambu delete old-print.3mf

# Calibration
bambu calibrate bed
bambu calibrate vibration
bambu calibrate flow
bambu calibrate all

Common Agent Workflows

"Print this file"

bambu job upload-and-print ./part.3mf
bambu watch  # monitor until done

"Check if printer is ready"

bambu status --json | jq '.gcode_state'
# IDLE = ready, RUNNING = busy, FAILED = needs attention

"What filament is loaded?"

bambu ams --json

"Preheat for PLA"

bambu heat nozzle:210 bed:60

"Preheat for ABS"

bambu heat nozzle:260 bed:100

"Something went wrong"

bambu errors --json   # check HMS error codes
bambu status          # full state overview

"Finish up and shut down"

bambu cooldown
bambu light off

Output Modes

Default: Human-readable, emoji-prefixed, compact. Optimized for LLM context windows.
--json: Raw JSON for programmatic parsing. Use with jq for field extraction.

Safety Notes

bambu status, bambu temp, bambu ams, bambu errors, bambu version, bambu files are read-only and always safe.
bambu print, bambu stop, bambu heat, bambu move, bambu gcode control the printer physically. The nozzle is 200°C+. Use judgment.
bambu calibrate moves the printer head. Ensure bed is clear.
bambu gcode sends raw G-code. Know what you're sending.

Troubleshooting

Issue	Fix
Connection timeout	Developer Mode enabled? Correct IP? Printer on?
Auth failed	Check LAN access code (it changes if you re-enable Developer Mode)
FTP error	Port 990, implicit TLS. Printer must be in LAN mode.
No AMS data	AMS connected and detected? Check printer touchscreen.
MQTT drops	WiFi signal weak? Check `bambu status` for wifi_signal field.

---name: bambudescription: Control Bambu Lab 3D printers (H2D, X1C, P1S, A1) via CLI. Print management, AMS filament control, temperature, fans, lights, calibration, file management, and live monitoring. Use when operating a 3D printer, starting prints, monitoring progress, managing filaments, or troubleshooting printer issues.---# Bambu Lab 3D Printer ControlFull control of Bambu Lab printers via MQTT + FTP. Agent-agnostic, local-only, no cloud.## Prerequisites- Printer must be in **Developer Mode** (Settings → LAN Only → Enable Developer Mode)- Need: IP address, serial number, LAN access code (from printer touchscreen)- CLI: `@versatly/bambu` installed globally (`npm i -g @versatly/bambu`)## Setup```bashbambu setup <ip> <serial> <access_code>bambu ping # verify connection```Config stored at `~/.bambu/config.json`.## Progressive Loading GuideLoad ONLY what you need for the current task:### Level 1: Status Check (most common)```bashbambu status # full status overviewbambu status --json # programmatic accessbambu temp # just temperatures bambu ams # just AMS/filament infobambu errors # any active errors```### Level 2: Print Operations```bash# Start a print from SD cardbambu print "filename.3mf"# Upload and print in one stepbambu job upload-and-print ./my-part.3mf# Control running printbambu pausebambu resume bambu stop# Live monitoring (streams progress)bambu watch```### Level 3: Hardware Control```bash# Temperaturebambu heat nozzle:220 bed:60bambu cooldown# Fans (0-100%)bambu fan part 80bambu fan aux 50bambu fan chamber 30# Lightsbambu light onbambu light off# Movementbambu homebambu move x:10 y:20 z:5bambu gcode "G28"```### Level 4: AMS Filament Management```bash# Check what's loadedbambu ams# Load specific tray (0-3)bambu load 0bambu load 2# Unload current filamentbambu unload```### Level 5: File Management & Calibration```bash# SD card filesbambu filesbambu upload ./part.3mfbambu delete old-print.3mf# Calibrationbambu calibrate bedbambu calibrate vibrationbambu calibrate flowbambu calibrate all```## Common Agent Workflows### "Print this file"```bashbambu job upload-and-print ./part.3mfbambu watch # monitor until done```### "Check if printer is ready"```bashbambu status --json | jq '.gcode_state'# IDLE = ready, RUNNING = busy, FAILED = needs attention```### "What filament is loaded?"```bashbambu ams --json```### "Preheat for PLA"```bashbambu heat nozzle:210 bed:60```### "Preheat for ABS"```bashbambu heat nozzle:260 bed:100```### "Something went wrong"```bashbambu errors --json # check HMS error codesbambu status # full state overview```### "Finish up and shut down"```bashbambu cooldownbambu light off```## Output Modes- **Default:** Human-readable, emoji-prefixed, compact. Optimized for LLM context windows.- **--json:** Raw JSON for programmatic parsing. Use with `jq` for field extraction.## Safety Notes- `bambu status`, `bambu temp`, `bambu ams`, `bambu errors`, `bambu version`, `bambu files` are **read-only and always safe**.- `bambu print`, `bambu stop`, `bambu heat`, `bambu move`, `bambu gcode` **control the printer physically**. The nozzle is 200°C+. Use judgment.- `bambu calibrate` moves the printer head. Ensure bed is clear.- `bambu gcode` sends raw G-code. Know what you're sending.## Troubleshooting| Issue | Fix ||-------|-----|| Connection timeout | Developer Mode enabled? Correct IP? Printer on? || Auth failed | Check LAN access code (it changes if you re-enable Developer Mode) || FTP error | Port 990, implicit TLS. Printer must be in LAN mode. || No AMS data | AMS connected and detected? Check printer touchscreen. || MQTT drops | WiFi signal weak? Check `bambu status` for wifi_signal field. |

Frequently asked questions