Skip to main content
Glama

deckapp-mcp

MCP support for DeckApp, so tools like Claude can build and run your decks. It works on the same deck files as the app, whether or not DeckApp is open.

Requirements

DeckApp 3.0 or newer, installed so that import deckapp works. The .deb puts it in /usr/lib/python3/dist-packages, which a virtualenv can see if you create it with --system-site-packages.

Related MCP server: streamdeck-mcp

Install

git clone https://github.com/prabhatm021/deckapp-mcp.git
cd deckapp-mcp
python3 -m venv --system-site-packages .venv
.venv/bin/pip install .

Check it found DeckApp:

.venv/bin/python -c "import deckapp; print(deckapp.__version__)"

Connect it

Claude Code:

claude mcp add deckapp -- /path/to/deckapp-mcp/.venv/bin/deckapp-mcp

Claude Desktop, or any client with a JSON config:

{
  "mcpServers": {
    "deckapp": {
      "command": "/path/to/deckapp-mcp/.venv/bin/deckapp-mcp"
    }
  }
}

Use the full path. The venv's deckapp-mcp is the one that knows where DeckApp lives.

Tools

26 of them, covering the same ground as the app: create, rename, resize, duplicate, reorder and delete decks; add, edit, move and remove buttons; import icons; read and set toggle states; export and import a deck as JSON; open a deck window. Run list_decks first to see what ids you have.

There is also press_button, which runs a button's command and hands back the exit code and output. That makes it easy to check a deck works, and it means anything connected to this server can run whatever your decks run. It is shell access, so treat it that way.

Positions are zero indexed, row 0 column 0 being the top left key.

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Provides AI assistants with the ability to control Linux desktop environments through tools for file management, application launching, and system operations like clipboard access. It includes a multi-level security model to manage permissions for safe, elevated, and restricted actions.
    6
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to directly control a Mirabox Stream Dock N3 via tools for key/screen updates, brightness, power, event listening, and layout management.
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP-capable AI agents such as Claude, Codex, Gemini CLI, Cursor and Zed to design and manage a Stream Deck by reading layouts, building pages and keys, setting icons and wallpapers, managing profiles and taking screenshots to verify their own work. Access is governed by read-only, edit-layout and full-control levels, with approval prompts before any tool runs something on the user's computer.
    MIT