Logic Pro MCP Server
MongLong0214/logic-pro-mcp
API natural para Logic Pro via Claude — mixer, MIDI, transporte e plugins
Ver no GitHubServidor MCP que oferece controle natural em linguagem de Logic Pro via Claude e outros clientes MCP. Combina 7 canais nativos de controle do macOS (mixer, transporte, composição MIDI, biblioteca, plugins) em uma interface unificada e bidirecional, permitindo que assistentes de IA controlem determinsticamente mixagem, automação e composição.
Instalação
npx convez-ai MongLong0214/logic-pro-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Composição automática de loops e sequências MIDI com instruções em linguagem natural
- Controle remoto de mixer, faders e efeitos via Claude durante sessões de produção
- Automação de workflows repetitivos em projetos de música (transporte, seleção de instrumentos, parâmetros)
Veredito

Projeto sólido e específico que preenche uma lacuna real: Logic Pro carece de API pública robusta. A abordagem de combinar 7 canais de controle é engenhosa e os 1208 testes passando indicam confiabilidade. Voltado para produtores musicais avançados que querem integrar IA em workflows profissionais.
README
A tradução para o português deste README ainda está na fila.
If this project helps you make music with Claude, Cursor, or any MCP client, give it a star. It helps this repo reach more Logic Pro users.
Logic Pro has no public API. This server bridges that gap by combining 7 native macOS control channels into a single MCP interface — giving AI assistants bidirectional, deterministic control over transport, mixing, MIDI composition, plugins, automation, and project lifecycle.
You: "Make a 4-bar techno loop in A minor at 140 BPM"
Claude → logic_tracks.record_sequence {
bar: 1, tempo: 140,
notes: "45,0,95;57,107,95;45,214,95;..."
}
Claude → logic_tracks.set_instrument {
index: 0, path: "Electronic Drums/Roland TR-909"
}
Logic Pro: region imported, TR-909 loaded, ready to play.
Why this exists
Logic Pro ships without an AppleScript dictionary rich enough for composition workflows, without OSC, and without a first-party MCP server. Every existing "Logic automation" tool either:
- Relies on screen-scraping via vanilla AppleScript (slow, fragile, breaks every Logic update)
- Simulates keyboard shortcuts (no state awareness, no feedback)
- Uses a single protocol like MCU alone (misses 80% of Logic's surface)
This server takes a different approach: combine seven complementary channels, route each operation to the channel best suited for it, and expose a clean MCP tool surface on top.
What it does
Mixer — Control faders, pan, sends, plugin parameters with 14-bit MCU resolution. Bidirectional: state cache reflects what Logic actually did, not what you requested.
Transport — Play, stop, record, locate, cycle, tempo, metronome. Sub-millisecond CoreMIDI MMC path; AX dialog fallback for precise bar positioning that auto-extends the project length.
MIDI composition — record_sequence generates a Standard MIDI File server-side and imports it into a new track. Zero timing drift regardless of system load; notes land at the exact requested bar.
Library & instruments — Enumerate Logic's full instrument library (Electronic Drums, Synthesizer, Bass, etc.) and load presets by path. Tree-scan caches to disk for instant subsequent lookups.
Plugins — Deterministic plugin parameter control via a Scripter JS insert on the selected track.
Navigation — Goto bar, markers by name, zoom, view toggles.
Project lifecycle — New, open, save, save-as, close, bounce, quit — all with explicit destructive-operation confirmation.
Quick Start
Prerequisites: macOS 14+, Logic Pro 12.0.1+. GitHub Actions/Homebrew release assets are universal (arm64 + x86_64); historical local ADHOC prerelease cuts may still be arm64-only, so audit a specific tag via RELEASE-METADATA.json when needed.
Release note, 2026-06-09: v3.4.6 is the current stable GitHub Release. It ships ADHOC-signed universal artifacts when Apple Developer ID credentials are absent, plus SHA256SUMS.txt and RELEASE-METADATA.json for the fail-closed installer path.
Option A — Homebrew (recommended)
brew tap MongLong0214/logic-pro-mcp https://github.com/MongLong0214/logic-pro-mcp
brew install logic-pro-mcp
The Homebrew formula pins both the release tarball URL and its SHA256; Homebrew itself is a trusted delivery channel with its own signature chain. This is the hardened path for production installs.
Option B — Download-inspect-run one-line installer
The installer is fail-closed: it refuses to run without explicit LOGIC_PRO_MCP_SHA256 + LOGIC_PRO_MCP_TEAM_ID env pins. Inspect the script first, then execute with the pins copied from the release's SHA256SUMS.txt:
curl -fsSL https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/v3.4.6/Scripts/install.sh -o install.sh
# inspect install.sh, then:
LOGIC_PRO_MCP_SHA256=<paste from release SHA256SUMS.txt> \
LOGIC_PRO_MCP_TEAM_ID=<paste team_id from RELEASE-METADATA.json> \
bash install.sh
If you knowingly accept same-origin provenance (hash + Team ID fetched from the same release as the binary), opt in explicitly:
LOGIC_PRO_MCP_ALLOW_SAME_ORIGIN=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/v3.4.6/Scripts/install.sh)
See SECURITY.md §Installer trust model for the trust tiers and threat model.
Either path installs the binary, verifies its SHA256, registers with Claude Code, and stages the Key Commands mapping reference (Logic 12.2+ does not auto-import; the reference assists Manual MIDI Learn — see Setup Guide §MIDIKeyCommands). It does not configure the MCU control surface or Scripter insert — see the Setup Guide for those two manual steps (~5 minutes).
Then test in Claude:
"Check Logic Pro MCP health and show all ready channels."
Expected: all 7 channels ready (or 5 if you skipped Key Commands and Scripter).
Architecture at a Glance
┌─ MCP Client (Claude / Desktop / Code) ─┐
│ │
│ logic_transport logic_tracks │
│ logic_mixer logic_midi │
│ logic_edit logic_navigate │
│ logic_project logic_system │
│ │
└─────────────────┬───────────────────────┘
│ stdio
┌─────────────────▼───────────────────────┐
│ LogicProMCP Server (Swift) │
│ │
│ ┌─ ChannelRouter (130+ operations) ──┐ │
│ │ routes operation → best channel │ │
│ └───────────────────┬───────────────┘ │
│ │ │
│ ┌──────┬──────┬─────▼─────┬──────┐ │
│ │ MCU │ AX │ AppleScript│CoreMIDI│ │
│ │ │ │ │ │ │
│ │ CGEvent Scripter KeyCmds │ │
│ └──────┴──────┴───────────┴────────┘ │
│ │ │
└──────────────────────┼──────────────────┘
│ MIDI / AX / AppleScript
┌──────▼───────┐
│ Logic Pro │
└──────────────┘
See Architecture for deeper details on channel priorities and state flow.
Documentation
| Document | Audience | Purpose |
|---|---|---|
| Setup Guide | End users | One-page install + Logic Pro integration, ~10 min |
| API Reference | End users, MCP clients | All 8 tools, 9 resources, 3 templates, 130+ operations |
| Troubleshooting | End users | Common failures and fixes |
| Architecture | Contributors | Channel design, state flow, testing strategy |
| Maintainer Guide | Maintainers | Release, approvals, E2E checklist |
| Live Verify v3.4.6 | Maintainers, QA | Latest deterministic, coverage, release-build, packaging, and carried Logic Pro 12.2 issue-verification evidence |
| Security Policy | Security reviewers | Threat model, reporting, hardening |
| Changelog | Everyone | Per-release changes |
| Contributing | Contributors | Dev setup, PR workflow |
Status
Current stable release: v3.4.6 is published (2026-06-09 KST). This is the evidence/packaging alignment release after the v3.4.5 Logic Pro 12.2 mixer verification work for Issues #10-#13. Verification: swift test --no-parallel at 1197/1197, swift build -c release, python3 -m py_compile Scripts/live-e2e-test.py, ruby -c Formula/logic-pro-mcp.rb, coverage 70.81% region / 78.32% line, strict live E2E 285/285 from the final current-main Logic 12.2 attestation, targeted live Logic Pro 12.2 checks for #10-#13, and GitHub Release workflow 27186085967 with build plus macOS 14/15 install validation all passed. Published release metadata is team_id:"ADHOC" / signing:"adhoc" / architectures:["x86_64","arm64"].
Active contracts (the things callers most care about)
- Honest Contract envelope — every mutating op returns one of three states (
State Aconfirmed,State Buncertain withreason,State Chard failure witherror). Clients can switch on the envelope without parsing free-form text. See docs/HONEST-CONTRACT.md. - Fail-closed mutation targets — mixer faders, plugin params, marker delete/rename, track delete/duplicate require explicit
track/index. Pre-v3.3.0 missing target silently mutated row 0; v3.3.0+ rejects withrequires explicit '<param>'. - Target-faithful navigation —
goto_markerreturnselement_not_found(State C) on a cold cache instead of advancing the marker pointer to "next." Caller mustsystem.refresh_cacheand retry, or supply aname. - 1-based MIDI channel —
send_note/send_cc/record_sequence-notes-chaccept 1..16 (matches Logic's UI). Pre-v3.1.6 was 0-based. - Audit phase split —
[AUDIT] project.<command> rejected | confirmation_required | executeddistinguishes invalid calls, confirmation prompts, and actual route invocations. Pre-v3.4.0 emittedexecutedbefore validation. - Verified project saves —
project.save_asno longer trusts a successful AppleScript return alone. It verifies that the target.logicxpackage exists and that an existing package's modification time advanced; stale or missing packages return State Creadback_mismatch. - Constrained MIDI imports —
logic_midi.import_fileis exposed for sequenced import workflows, but only accepts a real.midfile that resolves under/tmp/LogicProMCP/after symlink and traversal cleanup. Each successful import must create a new live AX track; otherwise it returns State Creadback_mismatch. - Live project metadata —
logic://project/infopromotes live transport tempo/sample-rate when available, falls back per-field to saved project metadata, and does not pretend visible AX track rows are a full project track count.
Recent releases (one line each)
| Version | Date | Headline |
|---|---|---|
| v3.4.6 | 2026-06-09 | Stable GitHub Release: evidence/packaging alignment after v3.4.5, version surfaces synced, final strict live E2E documented as complete, ADHOC universal artifacts, SHA256 metadata, and macOS 14/15 install validation |
| v3.4.5 | 2026-06-09 | Stable GitHub Release: Logic 12.2 mixer AX readback restored, echo-independent fader verification, mixer provenance, plugins_source:"ax" snapshots, guarded insert_plugin, ADHOC universal artifacts, SHA256 metadata, and deterministic/coverage/live/release-workflow evidence |
| v3.4.5-rc8..rc12 | 2026-06-05/08 | Release-workflow and installer-validation hotfix series: bash 3.2, split universal build, candidate stdout, Team ID parser validation, macOS 14 validation floor |
| v3.4.5-rc7 | 2026-06-05 | Release-workflow hotfix reroll, universal binary selection now scans all executable candidates under .build and picks the first real fat Mach-O |
| v3.4.5-rc5 | 2026-06-05 | Save/readback and MIDI import hardening, live project/info tier merge, ProcessUtils Logic detection fallback, Library duplicate-name column targeting, and final v4 MIDI-only composition E2E |
| v3.4.5-rc4 | 2026-05-10 | Installer metadata parser fix — same-origin install path now reads team_id from one-line RELEASE-METADATA.json |
| v3.4.5-rc3 | 2026-05-10 | CI green, but superseded by rc4 because same-origin installer metadata parsing selected version instead of team_id |
| v3.4.5-rc2 | 2026-05-10 | CI gate aligned to deterministic swift test --no-parallel; superseded by rc3 due transport packet-sink recorder race in CI |
| v3.4.5-rc1 | 2026-05-10 | Strict live E2E parent-context closure — shell-owned tmux transport, long JSON-RPC PTY hardening, 259/259 live checks passing |
| v3.4.4 | 2026-05-09 | CI hotfix — MIDIClientCreate(-50) smoke-test skip on macos-15-arm64 (sandboxed runner has no CoreMIDI server) |
| v3.4.3 | 2026-05-09 | CI Coverage step find-based path resolution + diagnostic output |
| v3.4.2 | 2026-05-08 | ProjectAuditPhaseTests parallel-execution race fix (NSLock + @Suite(.serialized)) |
| v3.4.1 | 2026-05-08 | Boomer P2 sweep — fail-loud lipo parsing, audit-phase contract docstring, ci.yml awk validation, uninstall-keycmds.sh empty-backup guard |
| v3.4.0 | 2026-05-08 | Enterprise deferred-blocker closure (8/9): stdio launch parity (RB-2), release-workflow notarization gate (RB-4), install/uninstall non-TTY safety (RB-6), audit-phase split (H-1, BREAKING), goto_marker target-faithful (H-2, BREAKING), docs drift, CI coverage gate re-armed, AXValue force-cast hardening |
| v3.3.0 | 2026-05-08 | Enterprise P0 closure: mixer/marker fail-closed (BREAKING), track.duplicate State-A verified gate (BREAKING), signal-cleanup contract (SIGTERM/SIGINT → coordinated shutdown), live-e2e-test.py false-positive expectation removed |
| v3.2.0 | 2026-05-07 | Marker position_source provenance surfaced in resource extras; sub-bar nav accuracy honestly deferred to v3.3 (T0 live spike found Logic 12.2 dialog is a 4-segment AXSlider) |
| v3.1.11 | 2026-05-07 | Logic 12.2 marker parser strict 4-component, 13-locale menu paths, lenient 1–3 component policy removed (Issue #9) |
| v3.1.6 | 2026-05-04 | port: "keycmd" routing for logic_midi.send_*, 1-based MIDI channel (BREAKING), audited coverage matrix (Issue #1) |
| v3.1.0 | 2026-04-25 | Honest Contract introduced (resource envelope BREAKING) |
Per-release detail: CHANGELOG.md.
Distribution
Stable production tags use the GitHub Actions release workflow; the published RELEASE-METADATA.json records the signing mode, Team ID, and architectures for the exact artifact. When Developer ID credentials are absent, stable and prerelease tags publish ADHOC artifacts with team_id:"ADHOC". SHA256 pinning is mandatory for the fail-closed installer path. v3.4.6 is published as a stable ADHOC release with build and macOS 14/15 install validation in workflow 27186085967. See SECURITY.md §Release types.
Testing
- 1208 unit + integration tests on current main —
swift test --no-parallelPASS. Coverage spans Honest Contract envelopes, fail-closed mutation gates (mixer/marker/MIDI import), routing-audit invariants, AX hardening,LogicProjectFileReaderplist parsing + path validation, liveproject/infotier-merge,project.save_aspackage-mtime readback,LogicProServer.stop()signal-cleanup contract, deterministic transport packet-sink capture, installer metadata parsing, mixer AX readback, plugin-slot snapshots, guarded insert-plugin flow, and release/CI contract guards. - Live E2E (
Scripts/live-e2e-test.py) defaults to the release binary. Protocol/security/validation assertions run on any host; Logic/CoreMIDI-dependent checks skip unless a live Logic Pro session is detected. For attestation runs, useLOGIC_PRO_MCP_STRICT_LIVE=1 Scripts/live-e2e-test.sh; the shell wrapper launches the MCP server under a trusted tmux parent so macOS TCC evaluates the same stdio parent context instead of Python. Current strict attestation: 285 passed, 0 skipped, 0 failed. - Current live Logic Pro 12.2 validation —
.build/release/LogicProMCPlaunched cleanly, health reported all 7 channels ready, #10set_volumeverified via AX readback despite missing MCU echo, #11logic://mixerrefreshed from AX poll, #12plugins[]carriedplugins_source:"ax", and #13 guardedinsert_pluginverified the inserted Gain slot and refused an occupied slot. Fresh strict coverage: full live E2E plus targeted #10-#13 checks all passed. - CI coverage gate — hard gate
region ≥ 70%,line ≥ 78%, with an explicitline ≥ 90%target reported as advisory until the dedicated coverage-uplift work lands. Latest local coverage is73.62%region /81.06%line. The coverage job now fails closed on LLVM profile write errors instead of lettingdefault.profrawruntime errors pass as warning noise. - CoreMIDI smoke tests skip on macos-15-arm64 GitHub runners (
MIDIClientCreatereturns-50in the sandboxed image; production code path coverage on real macOS hosts is unchanged).
Known limitations
transport.set_tempotyped-entry path falls back to slider increment (10-BPM granularity) when Logic's tempo display can't accept text input. Set tempo manually in Logic once before relying on MCP tempo operations for sub-10-BPM precision.record_sequenceregions start at bar 1 and extend to the target bar (padding-CC strategy). Note timing inside the region is exact; the leading padding is inaudible but cosmetic. Trim after import via Logic's Edit → Trim menu if a tight region matters.MIDIKeyCommandschannel — Logic 12.2 doesn't accept the legacy.plistKey Commands import (the menu item is grayed out). The bundledkeycmd-preset.plistis staged as a Manual MIDI Learn reference; eight ops are effectively keycmd-only and require a one-time MIDI Learn binding. See docs/SETUP.md §4 for the audited coverage matrix.- Marker list resource (
logic://markers) returns[]honestly when Logic 12.2's Marker List window is closed — Apple removed theAXRulerrole from the arrange window subtree on 12.2, and user markers now live exclusively in that window'sAXTable. Auto-open is intentionally not shipped (would change focus without consent); track an opt-in via the issue tracker if you'd like it.
License
MIT. See LICENSE.
Contributing
Bug reports, PRs, and feature discussions are welcome. See CONTRIBUTING.md for the dev workflow.
Security vulnerabilities: please do not open a public issue. See SECURITY.md for the private disclosure process.