Name: ProPresenter 7 MCP Server
Author: alxpark

LABSCO SUMMARY

The whole ProPresenter control surface, with nothing sitting between the agent and the desk.

The tool list tracks the application's own endpoints closely enough that an agent can run a service end to end — cue advance, timers, stage messages, audience looks, capture start and stop — without anyone touching the machine. That fidelity has a price: the whole tool list rides in the model's context on every turn, and the naming distinguishes active, focused and UUID-addressed presentations, a distinction the agent has to keep straight or it will trigger the wrong thing. What it creates is limited to playlists, messages and prop collections; presentations, themes, masks and looks come from a library that already exists.

What it is

A control surface for a running ProPresenter 7 machine, exposing its presentation, playlist, announcement, audio, stage, timer and transport endpoints as 177 tools.

What you get

Advance the service: trigger the next or previous cue in the active, focused or a UUID-addressed presentation, jump to a cue index, or fire a slide group.
Run playlists from either side of the desk — focus or trigger the active playlist, step item by item, create playlists and rewrite their contents.
Drive announcements and audio as their own layers, each with separate focus, trigger and timeline controls, plus play, pause, skip and seek over any layer.
Read what is on air: focused and active presentation, current slide index, layer status, screen status, chord chart and the live audience look.
Work the clock: start, stop, reset or increment a timer, operate every timer at once, and read the video countdown and the system time.
Put text in front of people: create, update and trigger messages with token values, and show or hide a stage message.
Fire props, macros, clear groups and audience looks, and pull thumbnails for playlist items, props, masks, stage layouts and theme slides.
Start and stop capture, read its settings and available encodings, and set the configuration of audience and stage screens.

Requirements

ProPresenter 7 running and reachable from the machine the server runs on. No account, no key.

Setup effort

One command — npx -y @alxpark/propresenter-mcp

See installation options

USE CASES

Running the service from the booth without touching the keyboard

Step the current presentation cue by cue, check where the slide pointer actually is, and clear a layer when something needs to come off screen.

trigger_next_slidetrigger_previous_slideget_active_slide_indextrigger_presentation_cueclear_layer

Keeping the countdown honest when the service starts late

Read the state of every timer, then add time or restart the one that is driving the room.

timers_get_alltimers_starttimers_incrementtimers_operationtimers_get_video_countdown

Getting a late announcement in front of the room

Write the message once, show it to the audience with its token values filled in, mirror it to the stage screens, then take both down.

messages_createmessages_triggermessages_clearstage_show_messagestage_hide_message

Rebuilding the set list after the running order changes

Read the existing playlists, rewrite the contents of the one that moved, add a new one for the change, and fire the item that is next.

playlists_get_allplaylists_getplaylists_setplaylists_createplaylists_trigger_item

Checking what the audience is actually seeing before you cut

Confirm screen and layer state and the slide on air, then switch the live audience look if the wrong one is up.

status_get_screensstatus_get_layersstatus_get_slidelooks_get_currentlooks_trigger

Cueing the band's backing track and riding it

Find the audio playlist, fire the right item, then play, pause and read the playback position on the audio layer.

audio_get_playlistsaudio_trigger_playlist_itemtransport_playtransport_pausetransport_get_time

177 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`announcement_focus_active`

Focus the currently active announcement presentation

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y @alxpark/propresenter-mcp

MCP Clients

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "propresenter": {
      "command": "npx",
      "args": [
        "-y",
        "@alxpark/propresenter-mcp"
      ],
      "env": {
        "PROPRESENTER_URL": "http://localhost:50000",
        "PROPRESENTER_PASSWORD": "<YOUR_PROPRESENTER_PASSWORD>"
      }
    }
  }
}

This runs the published @alxpark/propresenter-mcp package, whose propresenter-mcp command is the same build/index.js the README's local-build block points at. Set PROPRESENTER_URL to your ProPresenter machine and port, and delete PROPRESENTER_PASSWORD if you set no API password.

ProPresenter 7 MCP Server

The whole ProPresenter control surface, with nothing sitting between the agent and the desk.

What it is

What you get

Requirements

Setup effort

Running the service from the booth without touching the keyboard

Keeping the countdown honest when the service starts late

Getting a late announcement in front of the room

Rebuilding the set list after the running order changes

Checking what the audience is actually seeing before you cut

Cueing the band's backing track and riding it

177 tools

announcement_focus_active

announcement_get_active

announcement_get_slide_index

announcement_get_timeline_status

announcement_timeline_operation

announcement_trigger_active

announcement_trigger_cue

announcement_trigger_next

announcement_trigger_previous

audio_focus_active_playlist

audio_focus_next_playlist

audio_focus_playlist

audio_focus_previous_playlist

audio_get_active_playlist

audio_get_focused_playlist

audio_get_playlist

audio_get_playlist_updates

audio_get_playlists

audio_trigger_active_next

audio_trigger_active_playlist

audio_trigger_active_previous

audio_trigger_focused_next

audio_trigger_focused_playlist

audio_trigger_focused_previous

audio_trigger_playlist

audio_trigger_playlist_item

capture_get_encodings

capture_get_settings

capture_get_status

capture_operation

clear_get_group

clear_get_groups

clear_layer

clear_trigger_group

find_my_mouse

focus_active_presentation

focus_next_presentation

focus_presentation

focus_previous_presentation

focused_timeline_operation

get_active_presentation

get_active_slide_index

get_chord_chart

get_chord_chart_updates

get_focused_presentation

get_focused_timeline_status

get_presentation

get_presentation_thumbnail

get_propresenter_version

get_timeline_status

global_groups_get_all

library_get

library_get_libraries

library_trigger_presentation

library_trigger_presentation_cue

looks_get

looks_get_all

looks_get_current

looks_trigger

macros_get

macros_get_all

macros_trigger

masks_get

masks_get_all

masks_get_thumbnail

messages_clear

messages_create

`announcement_focus_active`

`announcement_get_active`

`announcement_get_slide_index`

`announcement_get_timeline_status`

`announcement_timeline_operation`

`announcement_trigger_active`

`announcement_trigger_cue`

`announcement_trigger_next`

`announcement_trigger_previous`

`audio_focus_active_playlist`

`audio_focus_next_playlist`

`audio_focus_playlist`

`audio_focus_previous_playlist`

`audio_get_active_playlist`

`audio_get_focused_playlist`

`audio_get_playlist`

`audio_get_playlist_updates`

`audio_get_playlists`

`audio_trigger_active_next`

`audio_trigger_active_playlist`

`audio_trigger_active_previous`

`audio_trigger_focused_next`

`audio_trigger_focused_playlist`

`audio_trigger_focused_previous`

`audio_trigger_playlist`

`audio_trigger_playlist_item`

`capture_get_encodings`

`capture_get_settings`

`capture_get_status`

`capture_operation`

`clear_get_group`

`clear_get_groups`

`clear_layer`

`clear_trigger_group`

`find_my_mouse`

`focus_active_presentation`

`focus_next_presentation`

`focus_presentation`

`focus_previous_presentation`

`focused_timeline_operation`

`get_active_presentation`

`get_active_slide_index`

`get_chord_chart`

`get_chord_chart_updates`

`get_focused_presentation`

`get_focused_timeline_status`

`get_presentation`

`get_presentation_thumbnail`

`get_propresenter_version`

`get_timeline_status`

`global_groups_get_all`

`library_get`

`library_get_libraries`

`library_trigger_presentation`

`library_trigger_presentation_cue`

`looks_get`

`looks_get_all`

`looks_get_current`

`looks_trigger`

`macros_get`

`macros_get_all`

`macros_trigger`

`masks_get`

`masks_get_all`

`masks_get_thumbnail`

`messages_clear`

`messages_create`

`messages_delete`

`messages_get`

`messages_get_all`

`messages_trigger`

`messages_update`

`playlists_create`

`playlists_create_under`

`playlists_focus`

`playlists_focus_active_announcement`

`playlists_focus_active_presentation`

`playlists_focus_next`

`playlists_focus_previous`

`playlists_get`