SynthHub
Written from devices/arturia/microfreak.vendor.fw-microfreak-tools-0.1.0.json, updated 2026-10-26Edit on GitHubJSONCSVMIDNAMOSCQuery

Arturia MicroFreak running microfreak-tools 0.1.0 plugins

The Arturia MicroFreak MIDI implementation: 21 CC, each named, for Claude (MCP), SuperCollider or any OSC app.

  • sourcemaker's documentation
  • firmwaremicrofreak-tools-0.1.0
  • licenceApache-2.0
Maker
Arturia
Firmware
microfreak-tools 0.1.0 plugins (by gbryant)
Source
maker's documentation
Licence
Apache-2.0
README.mdfrom the author's repository; not claimed yet, anyone can improve it

From the README of gbryant/microfreak-tools at 396fcf4, licence Apache-2.0.

microfreak-tools

Command-line tools for the Arturia MicroFreak. Read and write presets, samples, wavetables and settings over MIDI, and patch and flash firmware. Plugins add custom firmware and the commands that use it, such as putting your own words on the Speech engine.

Not affiliated with, authorised by or endorsed by Arturia. No Arturia code or binaries are in this repository. Commands that need firmware take the path to an image you already own.

Install

uv tool install microfreak-tools     # puts `mfreak` on PATH

With the plugins, add a --with for each:

uv tool install microfreak-tools --with mfreak-speech --with mfreak-peek

To upgrade, uv tool upgrade microfreak-tools. With pipx, pipx install microfreak-tools, then pipx inject microfreak-tools mfreak-speech for each plugin.

From a clone, uv run mfreak doctor runs it without installing, with both plugins.

Reading audio files needs ffmpeg (brew install ffmpeg). Recording and USB support come with the package; on Linux, recording also needs the system libportaudio2. mfreak doctor reports anything missing.

Read the whole README on GitHub

Use of this device

In the last 30 days: calls from agents aimed at it, counted since 2026-11-18.

Communities

MIDI controls

21 controls, from the source at microfreak-tools 0.1.0 plugins (by gbryant)

General

Control CC Range Name to send
Glide 5 0–127 /microfreak_tools/general/glide

Oscillator

Control CC Range Name to send
Type 9 0–127 /microfreak_tools/oscillator/type
Wave 10 0–127 /microfreak_tools/oscillator/wave
Timbre 12 0–127 /microfreak_tools/oscillator/timbre
Shape 13 0–127 /microfreak_tools/oscillator/shape

Filter

Control CC Range Name to send
Cutoff 23 0–127 /microfreak_tools/filter/cutoff
Resonance 83 0–127 /microfreak_tools/filter/resonance

Cycling envelope

Control CC Range Name to send
Cycling env rise 102 0–127 /microfreak_tools/cycling_envelope/cycling_env_rise
Cycling env fall 103 0–127 /microfreak_tools/cycling_envelope/cycling_env_fall
Cycling env hold 28 0–127 /microfreak_tools/cycling_envelope/cycling_env_hold
Cycling env amount 24 0–127 /microfreak_tools/cycling_envelope/cycling_env_amount

Arpeggiator/sequencer

Control CC Range Name to send
Arpeggiator sequencer arp seq rate free 91 0–127 /microfreak_tools/arpeggiator_sequencer/arp_seq_rate_free
Arpeggiator sequencer arp seq rate sync 92 0–127 /microfreak_tools/arpeggiator_sequencer/arp_seq_rate_sync

LFO

Control CC Range Name to send
Rate free 93 0–127 /microfreak_tools/lfo/rate_free
Rate sync 94 0–127 /microfreak_tools/lfo/rate_sync

Envelope

Control CC Range Name to send
Attack 105 0–127 /microfreak_tools/envelope/attack
Decay 106 0–127 /microfreak_tools/envelope/decay
Sustain 29 0–127 /microfreak_tools/envelope/sustain
Filter amount 26 0–127 /microfreak_tools/envelope/filter_amount

Keyboard

Control CC Range Name to send
Hold button toggle 64 0–127 /microfreak_tools/keyboard/hold_button_toggle
Spice 2 0–127 /microfreak_tools/keyboard/spice

Performance MIDI

Notes, pitch bend and any CC are also available: /microfreak_tools/note/on <note> <velocity>, /microfreak_tools/cc/<number> <value>, /microfreak_tools/pitchbend <0-16383>, /microfreak_tools/program_change <n>.

JSON

The same MIDI as microfreak, which this firmware shares.

Use it

Find the MIDI ports, then start the bridge with this driver:

osc-bridge detect        # prints the ready-to-run line for what is plugged in
osc-bridge run --device arturia/microfreak.vendor.fw-microfreak-tools-0.1.0 --out-port <N> --in-port <M>

Then send OSC to 127.0.0.1:7777, for example:

osc-bridge osc-send /microfreak_tools/general/glide 63

From Claude or any MCP client, the osc-bridge mcp server exposes this driver as microfreak_tools: ask “what can the Arturia MicroFreak do?” and it reads this map with list_routes. See the MCP guide.

How it is recognised

  • The Arturia MicroFreak answers the MIDI Identity Request (F0 7E 7F 06 01 F7) with F0 7E ·· 06 02 00 20 6B 06 00 06 01 ….
  • Its firmware version is in bytes 12, 13, 14, 15 of the answer (each byte as a number).
  • Its USB MIDI port names hold “MicroFreak”.

osc-bridge detect sends these and picks this driver when they match.

Programs and banks

A program change selects a sound.

Bank Bank select (CC 0 / CC 32) Program change Numbers Shown as
001-128 0 / – 0–127 1–128 001-128
129-256 1 / – 0–127 129–256 129-256
257-384 2 / – 0–127 257–384 257-384
385-512 3 / – 0–127 385–512 385-512

Recall one with /microfreak_tools/program/recall <bank> <number> (the bank by name, the number as shown).

Reading a stored sound back: a request names the stored program.

512 presets (1-512, user 129-512 since firmware 5.0): CC 0 = (preset - 1) / 128, then program change (preset - 1) mod 128, on channel 1; it changes the active sound only (ManageFreak docs/PROTOCOLLO.md and freakout microfreak_midi.py select_preset, both checked on the device). Presets read by Arturia SysEx F0 00 20 6B 07 01 \<seq> ..., operation 19h per preset 0-511 (Elektroid).

Limitations

microfreak-tools 0.1.0 by gbryant (Apache-2.0): preset, sample and wavetable transfer over SysEx/USB, and plugins that patch the firmware (mfreak-speech: a custom Speech-engine vocabulary; mfreak-peek). The MIDI chart is unchanged. Untested on hardware.

Firmwares

The Arturia MicroFreak runs 5 firmwares SynthHub maps, each with its own MIDI or another's it shares. All the devices with several: firmwares.

Firmware From Licence MIDI Sounds
freakpatch 0.3.0, Release + matrix build github.com/ThisFreakDoesntExist its own
freakpatch 0.3.0, Release build github.com/ThisFreakDoesntExist its own
FreakSwap 8705fc3 github.com/doriamxyz same as arturia/microfreak
microfreak-tools 0.1.0 plugins github.com/gbryant Apache-2.0 same as arturia/microfreak
SuperFreaker 0.1.2 freakierfirmware.com its own

Other sources

The Arturia MicroFreak is mapped in 6 versions. per pencilresearch canonical CSV.

Frequently asked questions

Which MIDI CC controls the filter cutoff on the Arturia MicroFreak?

CC 23 (0–127), named /microfreak_tools/filter/cutoff in SynthHub's map.

How many parameters of the Arturia MicroFreak can be controlled over MIDI?

SynthHub's map of the Arturia MicroFreak lists 21 MIDI CC parameters, each with its number, range and a readable name; the full chart is on this page.

Can an AI agent like Claude control the Arturia MicroFreak?

Yes: SynthHub's hosted MCP server knows the Arturia MicroFreak's MIDI map, and its browser relay lets the agent send it parameter changes or load a sound, each sound change confirmed by you.