Streamdeck MCP - install, status & alternatives [2026]

01 · Install Streamdeck MCP

Claude Code

claude mcp add verygoodplugins-streamdeck-mcp -- uvx streamdeck-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package streamdeck-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.verygoodplugins is GitHub-verified and matches the repo owner

03 · What Streamdeck MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search configured buttons/dials across profiles and return paste-ready native action objects for streamdeck_write_page, list desktop profiles, device metadata, page directories, and active profile roots from ProfilesV3 or ProfilesV2, read a page manifest and return simplified button details plus raw native action objects, and create or rewrites a page manifest. Prefer action from find_actions / button.raw when reusing configured third-party plugin actions.

The 9 tools it gives your agent

Extracted from the project's README - what streamdeck-mcp lets an agent do.

streamdeck_find_actions: - Searches configured buttons/dials across profiles and returns paste-ready native action objects for streamdeck_write_page.
streamdeck_read_plugins: - Lists installed Stream Deck plugins and declared actions from readable plugin manifests. Protected or binary manifests are reported with diagnostics instead of
streamdeck_read_profiles: - Lists desktop profiles, device metadata, page directories, and active profile roots from ProfilesV3 or ProfilesV2.
streamdeck_read_page: - Reads a page manifest and returns simplified button details plus raw native action objects.
streamdeck_write_page: - Creates or rewrites a page manifest. Prefer action from find_actions / button.raw when reusing configured third-party plugin actions.
streamdeck_create_icon: - Generates button or touch-strip PNGs from Material Design Icons or text. Icons are bundled offline; unknown names return close-match suggestions.
streamdeck_create_action: - Creates an executable shell script in ~/StreamDeckScripts/ and returns an Open action block.
streamdeck_restart_app: - Restarts the macOS Stream Deck desktop app after profile changes.
streamdeck_install_mcp_plugin: - Installs the bundled streamdeck-mcp Stream Deck plugin used for durable encoder imagery. Usually auto-installed by streamdeck_write_page.

Latest releases

v0.3.0 · 2026-04-28

0.3.0 (2026-04-28) · bundle Material Design Icons for offline glyph rendering · preserve encoder controller + Stream Deck + XL layout · refuse writes while Elgato app is running + restart_app path fix…

v0.2.0 · 2026-03-23

0.2.0 (2026-03-23) · make profile writer the default streamdeck server

v0.1.2 · 2025-12-25

04 · Who maintains Streamdeck MCP

streamdeck-mcp is maintained by verygoodplugins. We track 8 MCP servers from verygoodplugins - 8 actively maintained, 230 combined GitHub stars, oldest repo from Aug 2025. Full record: all servers from verygoodplugins.

05 · Facts

repository: github.com/verygoodplugins/streamdeck-mcp
category: automation - ranked #46 of 194 actively-maintained automation servers as of 2026-08-25.
registry: io.github.verygoodplugins/streamdeck-mcp (active, first published 2025-12-25)
packages: pypi:streamdeck-mcp

06 · Streamdeck MCP FAQ

Is Streamdeck MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Streamdeck MCP do?

With this server connected, an agent can search configured buttons/dials across profiles and return paste-ready native action objects for streamdeck_write_page, list desktop profiles, device metadata, page directories, and active profile roots from ProfilesV3 or ProfilesV2, read a page manifest and return simplified button details plus raw native action objects, and create or rewrites a page manifest. Prefer action from find_actions / button.raw when reusing configured third-party plugin actions.

How do I install Streamdeck MCP?

Run `uvx streamdeck-mcp`. You can also paste the ready-made client config above.

Does Streamdeck MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Streamdeck MCP

Alternatives to Streamdeck MCP

Maintained automation servers if Streamdeck MCP isn't the fit.

More automation MCP servers · Coda · Humane Proxy · Cookidoo MCP · Halo PSA · NoteStore Lab MCP

More Python MCP servers · Apple Books · Attestix · MetaTrader 5 MCP Bridge · Vinv · Wander Agent · see all