QD35 MCP
Enables discovery and control of an Edifier QD35 speaker over Bluetooth Low Energy, including status, volume, input selection, EQ, lighting, media playback, clock sync, LDAC, and gated device management.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
QD35 MCP
A local Model Context Protocol server that lets an agent control an Edifier QD35 over Bluetooth Low Energy. It talks directly to the speaker; the discontinued Edifier Connect mobile app is not required.
The protocol is independently implemented from observed behavior and Edifier Connect command definitions. It has been exercised against a physical QD35 running firmware 1.3.0. This project is not affiliated with Edifier.
What it controls
Read complete status: identity, firmware, volume, input, EQ, lights, and LDAC
Set volume using the speaker-reported range (firmware 1.3.0 reports 0–16)
Select Bluetooth, AUX, or USB input
Select Music, Game, Movie, or DIY EQ
Adjust the six DIY bands: 62 Hz, 250 Hz, 1 kHz, 4 kHz, 8 kHz, and 16 kHz
Select lighting effects and change RGB color, brightness, speed, or on/off state
Play/pause and skip the active Bluetooth player
Sync the clock and choose 12/24-hour display
Select LDAC off, 48/44.1 kHz, or 96 kHz
Rename, disconnect Bluetooth audio, power off, or factory-reset the speaker
The app's 32 built-in BGM tracks are audio files played by the phone, not stored speaker commands, so they are not redistributed. Firmware update is intentionally excluded from the agent interface.
Related MCP server: mcp-divoom-lan
Requirements
Linux with BlueZ and a working Bluetooth adapter
Python 3.11+
A powered-on QD35 nearby
The BLE control channel does not require pairing. Classic Bluetooth pairing is still needed for audio playback.
Install and run
Using uv:
uv tool install .
QD35_ENABLE_WRITES=1 qd35-mcpFor development:
uv sync --extra dev
QD35_TRANSPORT=fake uv run qd35-mcpThe fake transport is deterministic and useful for checking an MCP host without a speaker. It proves the server contract, not Bluetooth compatibility.
MCP host configuration
Use an absolute executable path when a desktop host has a restricted PATH:
{
"mcpServers": {
"qd35": {
"command": "/home/you/.local/bin/qd35-mcp",
"env": {
"QD35_ENABLE_WRITES": "1"
}
}
}
}To enable reset, shutdown, and audio disconnect, also set QD35_ENABLE_DANGEROUS=1. MCP host approval dialogs are still useful; the environment gate is defense in depth.
If exactly one QD35 is visible, it is selected automatically. Otherwise set QD35_DEVICE to its BLE address:
"QD35_DEVICE": "64:68:70:64:37:0D"Do not copy that example address unless it is your speaker.
Tools
Tool | Purpose |
| Bounded BLE scan, without pairing or connecting |
| Read all useful current state |
| Show supported, excluded, and gated operations |
| Set and read back volume |
| Select |
| Select |
| Set band 0–5 from -3 to +3 dB in 0.5 dB steps |
| Change effect, RGB, brightness, speed, or enabled state |
|
|
| Sync time and select |
| Select |
| Rename using up to 24 UTF-8 bytes |
| Drop the Classic Bluetooth audio link |
| Remote shutdown; remote power-on is not supported |
| Clear pairings and settings |
Every setting tool reads state back when the device allows it. A connection loss after a write is reported as an uncertain outcome. Firmware 1.3.0 stops advertising BLE after an LDAC change, so that tool asks for a power-cycle/reconnect and a fresh status check; it avoids the restart entirely when the requested mode is already active.
Configuration
Variable | Default | Meaning |
|
|
|
| auto | BLE address allowlist/target |
| system default | Optional BlueZ adapter such as |
|
| Enable ordinary state changes |
|
| Enable reset, power-off, and audio disconnect |
|
| Discovery time in seconds |
|
| Per-command response timeout |
Logs go to stderr; stdout remains reserved for MCP messages.
Troubleshooting
No device found: keep the speaker powered on and close Edifier Connect. The BLE advertisement has no local name on firmware 1.3.0, so name-only scanners miss it.
Permission error: ensure the user session can access BlueZ over D-Bus. Test with
bluetoothctl scan le.Device busy: only one controller may hold the BLE connection. Close the phone app and retry.
LDAC disconnect: expected. On tested firmware, an actual LDAC change requires power-cycling/reconnecting the speaker before
qd35_get_statuscan verify it.Audio is not connected: BLE control and Classic Bluetooth audio are separate links.
See docs/app-features.md, docs/protocol.md, and docs/hardware-validation.md for the evidence and current limits.
Development
uv sync --extra dev
uv run ruff check .
uv run pytest
uv buildContributions are welcome. Read CONTRIBUTING.md and do not submit proprietary app assets, personal Bluetooth identifiers, or unverified command mappings as facts.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Control and query Heiman smart home devices: lights, AC, curtains, climate, logs and scenes.
1Audio for your agent: transcribe, speak, translate, summarise, plus sound effects and music.
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Give your AI agent the power to cast to your home TV and control an interactive canvas. By ArdaBot.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables communication with G1 Bluetooth devices using the Nordic UART protocol over BLE. Supports device discovery, connection management, and message exchange for G1 audio devices through natural language commands.52MIT

mcp-divoom-lanofficial
AlicenseBqualityBmaintenanceEnables AI clients to control Divoom LAN devices, including watchface management, brightness adjustment, and screen control through natural language.4247 npm7MIT- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control Bluetooth audio devices via MCP tools, including battery status, connect/disconnect, find-my, and snoop decoding.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to discover, manage, and stream audio to LAN speakers supporting DLNA, AirPlay, and MiPlay, with playback of URLs, local files, and real-time PCM.4MIT