Control an OctoPrint 3D printer over its local REST API: print jobs, temperatures, file uploads, and gated raw G-code.

MITAuto-check passedBackend & APIs

Install Octoprint

skills CLI
$ npx skills add Anil-matcha/awesome-muse-connectors --skill octoprint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Anil-matcha/awesome-muse-connectors octoprint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/octoprint .claude/skills/octoprint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
octoprint
GitHub stars
1.3k
Token cost
~1.3k tokens
SKILL.md length
420 words
Files
2
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Control an OctoPrint 3D printer over its local REST API: print jobs, temperatures, file uploads, and gated raw G-code.

  • Works in 5 steps: HIGH: raw G-code (gcode) can physically… → MEDIUM: job start/pause/cancel/restart,… → connection disconnect mid-print cancels… → …
  • Phrases: octoprint
  • SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Octoprint is an agent skill from Anil-matcha/awesome-muse-connectors. Control an OctoPrint 3D printer over its local REST API: print jobs, temperatures, file uploads, and gated raw G-code. Trigger phrases: octoprint, 3d printer, start print, pause print, nozzle temperature, bed temperature, gcode.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/octoprint.py`).

It sits in Backend & APIs, covering File uploads and storage and REST APIs. The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

  • Phrases: octoprint
  • Nozzle temperature
  • Bed temperature

Example prompts

  • “/octoprint”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. HIGH: raw G-code (gcode) can physically damage the printer. The CLI requires both --enable-raw-gcode (explicit capability flag) and…
  2. MEDIUM: job start/pause/cancel/restart, file upload/select, and heater targets move or heat physical hardware. They need --confirm naming…
  3. connection disconnect mid-print cancels the print; the CLI warns but proceeds (LOW).
  4. There are no vendor quotas, but do not hammer a Raspberry Pi running OctoPrint: keep status polling to a few times a minute at most.
  5. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the API key value.

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Octoprint loads about 1.3k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 420 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 420 words, ~1,347 tokens.

Download SKILL.mdSave it as .claude/skills/octoprint/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
octoprint
description
Control an OctoPrint 3D printer over its local REST API: print jobs, temperatures, file uploads, and gated raw G-code. Trigger phrases: octoprint, 3d printer, start print, pause print, nozzle temperature, bed temperature, gcode.
metadata.includeInPrompt
true
tagline
Control an OctoPrint 3D printer over its local REST API: read printer state and temperatures, monitor print progress, start/pause/cancel/restart jobs, upload…
catalog_auth
API key via the secure credential flow
catalog_hosts
the host you pass via --host

OctoPrint

Purpose

Control an OctoPrint 3D printer over its local REST API: read printer state and temperatures, monitor print progress, start/pause/cancel/restart jobs, upload and select gcode files, set hotend and bed temperatures, jog or home axes, and (gated) run raw G-code. Use when the user mentions their OctoPrint instance or a printer it drives.

Tooling

All commands go through bin/octoprint.py. --host points at the OctoPrint instance (default $OCTOPRINT_HOST or http://localhost:5000); --insecure skips TLS verification for self-signed reverse proxies.

bash
bin/octoprint.py auth --host http://octopi.local:5000     # verify the API key
bin/octoprint.py version                                   # server version
bin/octoprint.py status                                    # printer state, hotend and bed temps
bin/octoprint.py job                                       # current print progress
bin/octoprint.py files                                     # list gcode files on the printer
bin/octoprint.py printhead --command home --x-home --y-home --z-home   # home axes (LOW)

# MEDIUM: --confirm "<exact effect>" on first use per printer, then proceed
bin/octoprint.py job-cmd --command start --confirm "start the print job on octopi.local"
bin/octoprint.py job-cmd --command pause --confirm "pause the print job on octopi.local"
bin/octoprint.py job-cmd --command cancel --confirm "cancel the print job on octopi.local"
bin/octoprint.py upload --path ./benchy.gcode --confirm "upload benchy.gcode to octopi.local"
bin/octoprint.py file-select --path benchy.gcode \
    --confirm "select file benchy.gcode for printing on octopi.local"
bin/octoprint.py tool-temp --tool tool0 --temp 210 \
    --confirm "heat tool0 to 210C on octopi.local (physical heater)"
bin/octoprint.py bed-temp --temp 60 \
    --confirm "heat the print bed to 60C on octopi.local (physical heater)"

# HIGH: raw G-code needs BOTH --enable-raw-gcode AND --confirm on EVERY call
bin/octoprint.py gcode --command "G28" --enable-raw-gcode --confirm "run raw G-code: G28"

job-cmd --command start starts the currently selected file; run file-select first if nothing is loaded. MEDIUM first-use confirmations are recorded locally (~/.cache/muse-connectors/octoprint/confirmed.json).

Auth

  • Provider id: octoprint (credential is collected as custom.octoprint)
  • Collection: API key generated in OctoPrint under Settings > Application Keys (or the global API key), stored via the secure credential flow (credentials.request_api_access); sent as the X-Api-Key request header
  • Allowed hosts: the hostname from --host (validated per call; the surrogate is only ever swapped on egress to that host)
  • Status check: bin/octoprint.py auth (must return "ok": true)
  • Remote access: OctoPrint is LAN-first. Reach it remotely through the OctoEverywhere free-tier relay, a VPN, or a reverse proxy; the connector does not implement any relay itself.
Show full SKILL.md (228 more words)Show less

Operating Rules

  1. HIGH: raw G-code (gcode) can physically damage the printer. The CLI requires both --enable-raw-gcode (explicit capability flag) and --confirm "run raw G-code: <command>" naming the exact command, on every call. Prefer the high-level commands (job-cmd, tool-temp, bed-temp, printhead) whenever they cover the need; reach for raw G-code only when nothing else does.
  2. MEDIUM: job start/pause/cancel/restart, file upload/select, and heater targets move or heat physical hardware. They need --confirm naming the exact effect on first use per printer. Heating a hotend or bed unattended is fire-adjacent: say so when confirming, and never set temperatures while the user is away without their explicit say-so.
  3. connection disconnect mid-print cancels the print; the CLI warns but proceeds (LOW).
  4. There are no vendor quotas, but do not hammer a Raspberry Pi running OctoPrint: keep status polling to a few times a minute at most.
  5. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the API key value.

Files

  • SKILL.md
  • bin/octoprint.py

Maturity

🧪 Draft: written from OctoPrint's public REST API docs; not yet live-tested end-to-end.

Honesty flags: endpoint paths and payload shapes (/api/job, /api/files, /api/printer/tool, /api/printer/bed, /api/printer/printhead, /api/printer/command, /api/connection) follow the official OctoPrint REST reference. Raw G-code is HIGH and doubly gated (--enable-raw-gcode plus per-call --confirm). The multipart upload body is standard form encoding but untested against a live OctoPrint here.

© Anil-matcha, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in connectors/octoprint of Anil-matcha/awesome-muse-connectors.

  • SKILL.md
  • bin/octoprint.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

Octoprint next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Octoprint compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Octoprint this skillAnil-matcha/awesome-muse-connectors1.3k—~1.3kAutomated safety check: PassMIT
Helpers And Infra Keeperdiscord-php/DiscordPHP1.1k—~2.3kAutomated safety check: PassMIT
Convex HTTP Actionswaynesutton/builder-skills406—~2.6kAutomated safety check: PassApache-2.0
Appdeploysickn33/agentic-awesome-skills47k2 repos~2.3kAutomated safety check: PassMIT
Canvas Lms APIaspi6246/Claude-Code-Skills-for-Academics159—~3.7kAutomated safety check: PassNone
Google Cloud Storage Bucket Architectgoogle/skills21k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • Helpers And Infra Keeper

    discord-php/DiscordPHP

    Work with DiscordPHP's infrastructure utilities — CacheWrapper, CacheConfig, BigInt, Multipart, Endpoint::bind URL templates, Collection base class, and domain Exceptions.

    1.1k GitHub stars~2.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Convex HTTP Actions

    waynesutton/builder-skills

    Adds HTTP endpoints in convex/http.ts: webhook receivers with signature checks, REST style routes, CORS, auth headers, streaming responses, and file uploads over HTTP.

    406 GitHub stars~2.6k tokensUpdated 13 days ago
    Backend & APIsAuto-check passed
  • Appdeploy

    sickn33/agentic-awesome-skills

    Deploy web apps with backend APIs, database, and file storage.

    47k GitHub starsUsed in 2 repos~2.3k tokens
    Backend & APIsAuto-check passed
  • Canvas Lms API

    aspi6246/Claude-Code-Skills-for-Academics

    A skill your agent uses whenever working with the Canvas LMS REST API — including creating or updating modules, pages, and files for a course, building sync scripts, managing course structure…

    159 GitHub stars~3.7k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Creates Cloud Storage on Google Cloud (also known colloquially as GCS) buckets.

    21k GitHub stars~2.6k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Dlsps User

    open-edge-platform/edge-ai-libraries

    Deploy and operate DL Streamer Pipeline Server — a microservice that wraps DL Streamer pipelines behind a REST API for containerized, no-code operation.

    171 GitHub stars~2.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from Anil-matcha/awesome-muse-connectors

All 153 skills in this repo
  • Airtable

    Anil-matcha/awesome-muse-connectors

    List Airtable bases, read table records, and add records. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~511 tokensUpdated 5 days ago
    Auto-check passed
  • Alphavantage

    Anil-matcha/awesome-muse-connectors

    Stock quotes and daily price history. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~517 tokensUpdated 5 days ago
    Auto-check passed
  • Amadeus

    Anil-matcha/awesome-muse-connectors

    Search travel with Amadeus: flight offers and prices, airport autocomplete, hotel offers, cheapest dates.

    1.3k GitHub stars~699 tokensUpdated 5 days ago
    Auto-check passed
  • Apollo

    Anil-matcha/awesome-muse-connectors

    Search B2B contacts with Apollo.io: find people by title and company, enrich contacts and companies.

    1.3k GitHub stars~492 tokensUpdated 5 days ago
    Auto-check passed
  • Aqara

    Anil-matcha/awesome-muse-connectors

    Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes.

    1.3k GitHub stars~1.6k tokensUpdated 5 days ago
    Auto-check passed
  • Asana

    Anil-matcha/awesome-muse-connectors

    Read and manage Asana tasks: my tasks, task details, create tasks.

    1.3k GitHub stars~481 tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about Octoprint

What does Octoprint do?

Control an OctoPrint 3D printer over its local REST API: print jobs, temperatures, file uploads, and gated raw G-code. Octoprint is an agent skill from Anil-matcha/awesome-muse-connectors. Control an OctoPrint 3D printer over its local REST API: print jobs, temperatures, file uploads, and gated raw G-code.

When should I use Octoprint?

Octoprint fits situations like: phrases: octoprint; nozzle temperature; bed temperature.

How do I install Octoprint in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill octoprint -a claude-code`. Or copy the skill folder (connectors/octoprint in Anil-matcha/awesome-muse-connectors) into .claude/skills/octoprint in your project. Claude Code loads it when a task matches its description.

How do I install Octoprint in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill octoprint -a codex`. Or copy the skill folder (connectors/octoprint in Anil-matcha/awesome-muse-connectors) into .agents/skills/octoprint in your project. Codex loads it when a task matches its description.

Can I use Octoprint in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Anil-matcha/awesome-muse-connectors --skill octoprint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/octoprint, .gemini/skills/octoprint, .github/skills/octoprint and .opencode/skills/octoprint in your project.

What does Octoprint need to run?

Going by SKILL.md and its folder, Octoprint needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Octoprint access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Octoprint safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Octoprint use?

Octoprint is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Octoprint use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Octoprint?

Skills that share tags, products or a category with Octoprint: Helpers And Infra Keeper (discord-php/DiscordPHP, 1.1k stars), Convex HTTP Actions (waynesutton/builder-skills, 406 stars), Appdeploy (sickn33/agentic-awesome-skills, 47k stars) and Canvas Lms API (aspi6246/Claude-Code-Skills-for-Academics, 159 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Octoprint?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,347 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.