Stream Deck MCP

Stream Deck MCP lets agents build and reconfigure real Elgato Stream Deck profiles.

Quick Start · Demo · Features · Tools · Development

Tell your AI what Stream Deck you want. Get back a polished profile with buttons, icons, colors, dials, touch-strip art, and the shell scripts behind it. Stream Deck MCP writes the same profile format the Elgato desktop app already uses, so agents can author real local decks without making you build a Stream Deck plugin first.

It works with Claude Desktop, Claude Code, Cursor, Codex, and any MCP client that can launch a stdio server.

Quick Start

Claude Code:

claude mcp add streamdeck -- uvx streamdeck-mcp

Claude Desktop, Cursor, Codex, and other MCP clients can use the same command:

{
  "mcpServers": {
    "streamdeck": {
      "command": "uvx",
      "args": ["streamdeck-mcp"]
    }
  }
}

Then ask your agent for a deck:

Make me a Slack control board for my Stream Deck + XL.

For Claude Code, install the bundled designer skill for better layout, palette, hardware, and plugin-action guidance:

uvx --from streamdeck-mcp streamdeck-mcp-install-skill

Demo

_{Product trailer generated with Remotion, showing hardware inventory, plugin discovery, configured action reuse, and a final Stream Deck + XL reveal.}

Features

• Profile-native authoring - reads and writes Elgato ProfilesV3 files directly, with ProfilesV2 fallback for older installs.
• Hardware inventory - discovers profile pages, device model names, key geometry, dials, and touch-strip support before writing.
• Installed plugin discovery - scans readable Stream Deck plugin manifests with streamdeck_read_plugins so agents can find plugin and action UUIDs.
• Configured plugin action reuse - reads existing buttons with streamdeck_read_page and preserves plugin-specific settings by copying button.raw; it does not infer private property-inspector settings.
• Offline icon generation - renders button and touch-strip PNGs from about 7,400 bundled Material Design Icons, or from short text labels.
• Script-backed automations - creates executable shell scripts in ~/StreamDeckScripts/ and wires them to Stream Deck Open actions.
• Dial and touch-strip support - installs a minimal bundled Stream Deck plugin when needed so encoder imagery survives app restarts.
• Safe write cycle - guards against the Elgato app overwriting manifest edits by enforcing a quit, write, relaunch workflow.

Agentic Workflows

The point is not generic buttons. When your agent also has Slack, Home Assistant, OBS, GitHub, Hue, Spotify, or other MCP servers loaded, it can query those systems first and build around what is actually in your environment.

Try prompts like:

• "Make me a control board for Slack." Query channels, status, and unread state; create channel jumps, status toggles, read-all controls, and dials.
• "A hello-kitty-themed Home Assistant dashboard for the living room." Discover living-room entities, then lay out scenes, lights, and media controls in a matching visual style.
• "OBS control panel based on my actual scenes and audio inputs." Read scenes, sources, and devices; write scene switches, source toggles, and per-input dial controls.
• "A dev deck for this repo in Nordic colors." Read project scripts and GitHub context; create local command buttons, PR links,

... View full README on GitHub