Published: 2026-05-29
Kubb as a Claude Code plugin#
Kubb v5 already ships a built-in MCP server, so AI assistants can drive code generation over HTTP. The next step was to make that setup a single command. Kubb is now a Claude Code plugin. Install it from the marketplace and you get slash commands, a config skill, an expert agent, and the Kubb MCP server, all wired together.
Important
The plugin requires Kubb v5 or higher. It builds on the v5 CLI and the built-in MCP server.
Install#
Add the repository as a marketplace and install the plugin:
/plugin marketplace add kubb-labs/kubb
/plugin install kubb@kubb
The commands run npx kubb, so install Kubb in your project or globally first:
npm install -D kubb # in the project
npm install -g kubb # or globally
A SessionStart hook checks for kubb when a session starts and warns you when it is missing. It never installs anything itself, so nothing runs behind your back.
Three slash commands#
The plugin maps the Kubb CLI to commands you can call from a Claude Code session.
/kubb:init [input] [output] [plugins] scaffolds a kubb.config.ts and installs the @kubb/plugin-* packages you pick. Point it at a spec to start:
/kubb:init ./petstore.yaml
Claude asks which outputs you want, writes the config, and installs the packages. Run /kubb:generate to re-run codegen whenever the spec changes, and /kubb:validate <spec> to check an OpenAPI or Swagger document before you generate from it.
A skill and an agent#
The config skill teaches Claude how to write kubb.config.ts and which @kubb/plugin-* package maps to which output, so the config is correct rather than guessed.
For bigger jobs, the kubb-expert agent takes a whole "add Kubb to my project" task from spec to generated code. It picks plugins, scaffolds the config, runs generation, and reports what changed.
The MCP server, bundled#
The plugin wires in the Kubb MCP server (kubb mcp) through its .mcp.json. When you would rather describe what you want than run a command, the server lets Claude generate code against your config in conversation.
Try it locally#
Before installing from the marketplace, run the plugin straight from a checkout:
claude --plugin-dir ./tools/claude
The plugin is open source and lives in the kubb-labs/kubb repository. If you hit anything unexpected, open an issue on GitHub.
Kubb is community-driven. If it helps your team, consider sponsoring the project.