home / mcp / klipper mcp server
Provides a programmable API to control Klipper printers via Moonraker, exposing 100+ tools for status, gcode execution, toolchanging, diagnostics, files, camera, and maintenance.
Configuration
View docs{
"mcpServers": {
"charleslotto-klipper-mcp": {
"url": "http://localhost:8000/mcp",
"headers": {
"ARMED": "false",
"API_KEY": "your-secret-key",
"MCP_HOST": "0.0.0.0",
"MCP_PORT": "8000",
"ADMIN_PIN": "1234",
"TOOL_COUNT": "4",
"PRINTER_NAME": "Voron",
"MCP_TRANSPORT": "http",
"MOONRAKER_URL": "http://localhost:7125",
"SPOOLMAN_ENABLED": "True",
"CAMERA_STREAM_URL": "http://localhost/webcam/?action=stream",
"CAMERA_SNAPSHOT_URL": "http://localhost/webcam/?action=snapshot"
}
}
}
}Fetch complete printer status including temperatures, position, and current state.
Execute any G-code command on the printer.
Begin a print job from a selected G-code file.
Pause the current print job.
Resume a paused print job.
Cancel the active print job.
Home X, Y, Z axes or all axes.
Immediately halt all printer activity.
Restart the Klipper firmware.
Run the QGL procedure for gantry leveling.
Set target temperatures for hotend and bed.
Query the currently active tool in the toolchanger.
Attach a specific tool (T0-Tn) to the head.
Return the active tool to its dock.
Run the toolchanger initialization sequence.
Retrieve tool offset values.
Begin tool alignment workflow.
Test docking and undocking operations.
Disable crash detection during testing.
Fetch TMC driver status, currents, and temperatures.
Adjust TMC run and hold currents.
Dump TMC registers for diagnostics.
Read a specific TMC register field.
Write a value to a TMC register field.
Show TMC Autotune configuration.
List all steppers with TMC drivers.
List available LED effects.
Activate a specific LED effect.
Stop a running LED effect.
Stop all LED effects.
Directly control LED color (RGB/RGBW).
List preset LED scenes.
Apply a preset LED scene.
Browse available G-code files.
Read metadata for a G-code file.
Read contents of a G-code file.
Upload new G-code files to the printer.
Remove a G-code file from storage.
Search within a G-code file.
Read a Klipper config file like printer.cfg.
List Klipper config files.
Capture a current camera frame.
Provide MJPEG stream URL for cameras.
Fetch current timelapse configuration.
Enable or disable timelapse capture.
Capture a manual timelapse frame.
Trigger timelapse video render.
Adjust timelapse settings.
Retrieve past prints with optional filtering.
Return cumulative print statistics.
Show filament usage by material.
Provide a summary of recent prints.
Return average metrics across prints.
Export all printer data to JSON.
Analyze Klippy log for issues.
Show recent errors with context.
Provide a summary of logs.
Detect configuration problems.
Report MCU status and timing.
Show recently executed G-code commands.
Provide problem-specific guidance.
Diagnose print failures.
Validate configuration integrity.
Provide CPU, memory, and disk statistics.
Fetch temperatures for all heaters.
Retrieve historical temperature data.
Detect anomalies in temperature data.
Set alerts for temperature thresholds.
Run bed mesh calibration.
List saved bed mesh profiles.
Load a bed mesh profile.
Save the current bed mesh.
Remove the active bed mesh.
List all tracked spools.
Show the currently loaded spool.
Set the active spool for the toolhead.
Provide full details for a spool.
Warn about low filament conditions.
Show material-based filament usage.
List filament vendors.
Query the filament database.
Send multi-channel notifications.
Send a Discord webhook notification.
Send a Slack webhook notification.
Send a Pushover notification.
Convert text to speech for announcements.
Test all notification channels.
Query current notification settings.
Backup all configuration files.
List available backups.
Restore configuration from a backup.
Check upcoming maintenance intervals.
Record maintenance events.
Show maintenance history.
Access security audit log.
Export all data to JSON.
Provide a full analysis of a G-code file.
Check G-code for issues.
Extract comments from G-code.
Provide movement statistics from G-code.
Get data for a specific layer.
Diff two G-code files.