streamdeck-mcp

Overview

StreamDeck MCP is a specialized MCP server that bridges AI capabilities with Elgato Stream Deck hardware. It reads and writes Stream Deck profiles directly in the desktop app's native format, enabling users to generate complete deck configurations through natural language prompts. The server integrates with other MCP tools like Slack, Home Assistant, OBS, and GitHub to create contextual, personalized control boards that match actual hardware and software environments. Installation is straightforward via uvx with configuration options for Claude Desktop, Claude Code, Cursor, and other MCP clients.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• streamdeck_read_profiles

  Lists desktop profiles and page directories from the active ProfilesV3 or ProfilesV2 store

  Try:Show me my current Stream Deck profilesTry:List all available pages in my Stream Deck
• streamdeck_read_page

  Reads a page manifest and returns simplified button details plus the raw manifest

  Try:Display the contents of my Slack control board pageTry:Show me the buttons on page 3
• streamdeck_write_page

  Creates a new page or rewrites an existing page manifest

  Try:Create a new page called 'Meeting Controls'Try:Update my OBS scene switcher page
• streamdeck_create_icon

  Generates a PNG icon from a Material Design Icons name or from text

  Try:Create a Slack icon for my control boardTry:Make a touchstrip background with 'Music' text
• streamdeck_create_action

  Creates an executable shell script in ~/StreamDeckScripts/ and returns an Open action block

  Try:Create a script to mute my microphoneTry:Make a button that starts a screen recording
• streamdeck_restart_app

  Restarts the Stream Deck desktop app after profile changes (macOS only)

  Try:Restart the Elgato app to load my changesTry:Reload my Stream Deck profile
• streamdeck_install_mcp_plugin

  Installs the bundled streamdeck-mcp Stream Deck plugin into the Elgato Plugins directory

  Try:Install the Stream Deck pluginTry:Set up the MCP plugin for encoder support
• design_streamdeck_deck

  Creates a complete Stream Deck profile with buttons, icons, and actions based on user intent

  Try:Make me a Slack control boardTry:Create a Nordic-themed dev deck for this repo

Comparable tools

Installation

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

claude mcp add streamdeck -- uvx streamdeck-mcp

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

FAQ

Which MCP clients are supported?

StreamDeck MCP works with Claude Desktop, Claude Code, Cursor, Codex, and any MCP-compatible client that can run over stdio.

What about Linux compatibility?

On Linux, use the legacy USB mode via 'uvx --from streamdeck-mcp streamdeck-mcp-usb' since the Elgato desktop app is macOS/Windows only.

Compare streamdeck-mcp with