OpenDeck MCP server

opendeck-mcp

<!-- mcp-name: io.github.kastro5/opendeck-mcp -->

Set up your OpenDeck stream controller by asking an AI agent:

"Put a Multi Action on the top-left key that mutes my mic and opens Discord, make a 'Gaming'

profile from my default one, and switch to it whenever Steam is focused."

opendeck-mcp is an MCP server. It lets Claude Code (or any MCP client) read your decks, profiles and plugins, stage changes, show you a diff, and then apply them, with a backup you can undo. It works with any device OpenDeck drives: Elgato Stream Decks and plugin-provided devices such as the Ulanzi D200H/D200X.

Contents

• What it can do
• Install
• Upgrading
• Other MCP clients
• From another computer
• As an OpenDeck plugin
• Using it
• How it works
• Safety
• Tools
• Limitations
• Troubleshooting

What it can do

title and settings; and installed plugins with their actions.

• See everything: devices with their grid size, dials and touchpoints; profiles; every key's action,

and touchpoints, across profiles and devices.

• Edit keys: place, update (title, font, colour, image, settings), clear, move, swap or copy keys, dials

profiles, including Folder/Name profiles, and choose which one each device starts on.

• Multi and Toggle Actions: add and remove the actions inside them, and set the delays between them.
• Profiles: create, duplicate, rename (references to the old name are updated too) and delete

apply at once, with no restart; undo_live takes them back.

• App switching: switch a device to a profile automatically when an app is focused.
• Plugins:
• search the same catalogue as OpenDeck's Plugin Manager, plus the Elgato plugin archive;
• install, update and remove plugins;
• read and write plugin settings, with secrets redacted;
• read plugin logs.
• Instant edits: title, image and settings tweaks to a key on the profile a device is showing

folder keys that open a sub-profile with a Back key.

• Icons and folders: make key images from text, emoji, ~3,400 brand logos or ~7,400 symbols, and

before and after side by side, so you can check a layout before applying it.

• Pictures: render_profile shows the deck as OpenDeck draws it, with staged changes outlined or

that controls one, using the login already saved in the Home Assistant plugin.

• Home Assistant: find entities by name, area or domain, and get ready-made settings for a key

• Undo: every apply takes a backup, and restore_backup puts things back.

Install

You need OpenDeck 2.14, uv and Claude Code (or another MCP client, see below). uv fetches a suitable Python by itself.

claude mcp add opendeck --scope user -- uvx opendeck-mcp@0.4.0

Then restart Claude Code and ask it something like "what's on my OpenDeck?".

It's on PyPI and in the MCP Registry as io.github.kastro5/opendeck-mcp. To run straight from GitHub instead: uvx --from git+https://github.com/kastro5/opendeck-mcp@v0.4.0 opendeck-mcp.

OpenDeck's folders are found automatically. If yours live somewhere unusual, override them with environment variables (claude mcp add … -e NAME=value):

Shortened. The full README is on GitHub.