Propresenter MCP server
io.github.alxpark/propresenter-mcp·v1.0.1·13 starsProPresenter 7 MCP server
13 stars33 downloads/wk
Reviews
Write oneNobody has reviewed Propresenter yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Propresenter tools (100, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
announcement_focus_activeFocus the currently active announcement presentation
announcement_get_activeGet the currently active announcement presentation
announcement_get_slide_indexGet the index of the current slide within the active announcement
announcement_get_timeline_statusGet the current timeline status of the active announcement
announcement_timeline_operationPerform timeline operation (play, pause, rewind) on active announcement
announcement_trigger_activeRetrigger the currently active announcement (starts from beginning)
announcement_trigger_cueTrigger a specific cue by index in the active announcement
announcement_trigger_nextTrigger the next cue in the active announcement
announcement_trigger_previousTrigger the previous cue in the active announcement
audio_focus_active_playlistFocus the active audio playlist
audio_focus_next_playlistFocus the next audio playlist
audio_focus_playlistFocus a specific audio playlist
audio_focus_previous_playlistFocus the previous audio playlist
audio_get_active_playlistGet the currently active audio playlist
audio_get_focused_playlistGet the currently focused audio playlist
audio_get_playlistGet all items in a specific audio playlist
audio_get_playlist_updatesSubscribe to updates for a specific audio playlist (chunked response)
audio_get_playlistsGet a list of all configured audio playlists
audio_trigger_active_nextTrigger the next item in the active playlist
audio_trigger_active_playlistTrigger the active audio playlist (restart from beginning)
audio_trigger_active_previousTrigger the previous item in the active playlist
audio_trigger_focused_nextTrigger the next item in the focused playlist
audio_trigger_focused_playlistTrigger the focused audio playlist
audio_trigger_focused_previousTrigger the previous item in the focused playlist
audio_trigger_playlistTrigger a specific audio playlist
audio_trigger_playlist_itemTrigger a specific item in a specific playlist
capture_get_encodingsGet available capture encodings for a specific type
capture_get_settingsGet the current capture settings
capture_get_statusGet the current capture status and capture time
capture_operationPerform a capture operation (start or stop)
clear_get_groupGet details of a specific clear group
clear_get_groupsGet a list of all configured clear groups
clear_layerClear a specific layer (audio, props, messages, announcements, slide, media, video_input)
clear_trigger_groupTrigger a specific clear group
focus_active_presentationFocus the currently active presentation
focus_presentationFocus a presentation without triggering it
get_active_presentationGet the currently active presentation
get_active_slide_indexGet the index of the current slide within the active presentation
get_focused_presentationGet the currently focused presentation
global_groups_get_allGet all global groups configured in ProPresenter
library_getGet all items in a specific library
library_get_librariesGet a list of all configured libraries
library_trigger_presentationTrigger the first cue of a presentation in a library
library_trigger_presentation_cueTrigger a specific cue of a presentation in a library
looks_getGet details of a specific audience look
looks_get_allGet a list of all configured audience looks (except the live look)
looks_get_currentGet the details of the currently live audience look
looks_triggerTrigger a specific audience look to make it live/current
macros_getGet details of a specific macro
macros_get_allGet a list of all configured macros
macros_triggerTrigger a specific macro
masks_getGet details of a specific mask
masks_get_allGet all masks in the library
masks_get_thumbnailGet thumbnail for a specific mask
messages_clearClear (hide) a specific message
messages_createwrite actionCreate a new message
messages_deletewrite actionDelete a specific message
messages_getGet details of a specific message
messages_get_allGet a list of all messages
messages_triggerTrigger (show) a specific message with optional token values
messages_updatewrite actionUpdate an existing message
playlists_createwrite actionCreate a new playlist
playlists_create_underwrite actionCreate a new playlist under an existing playlist
playlists_focusFocus a specific playlist without triggering it
playlists_focus_active_announcementFocus the active announcement playlist
playlists_focus_active_presentationFocus the active presentation playlist
playlists_focus_nextFocus the next playlist
playlists_focus_previousFocus the previous playlist
playlists_getGet details of a specific playlist
playlists_get_activeGet the currently active playlist
playlists_get_active_announcement_thumbnailGet thumbnail for active playlist announcement item
playlists_get_active_presentation_thumbnailGet thumbnail for active playlist presentation item
playlists_get_allGet all playlists in the library
playlists_get_focusedGet the currently focused playlist
playlists_get_focused_nextGet the next item in the focused playlist
playlists_get_focused_previousGet the previous item in the focused playlist
playlists_get_thumbnailGet thumbnail for a specific playlist item
playlists_get_updatesGet updates for a specific playlist
playlists_setwrite actionUpdate the contents of a specific playlist
playlists_triggerTrigger a specific playlist
playlists_trigger_active_announcementTrigger the active announcement in the playlist
playlists_trigger_active_announcement_itemTrigger a specific announcement item in the active playlist
playlists_trigger_active_presentationTrigger the active presentation in the playlist
playlists_trigger_active_presentation_itemTrigger a specific presentation item in the active playlist
playlists_trigger_focusedTrigger the focused playlist item
playlists_trigger_focused_itemTrigger a specific item in the focused playlist
playlists_trigger_focused_nextTrigger the next item in the focused playlist
playlists_trigger_focused_previousTrigger the previous item in the focused playlist
playlists_trigger_itemTrigger a specific item in a playlist
playlists_trigger_nextTrigger the next item in a specific playlist
playlists_trigger_previousTrigger the previous item in a specific playlist
trigger_active_presentationRetrigger the currently active presentation (starts from beginning)
trigger_focused_cueTrigger a specific cue by index in the focused presentation
trigger_focused_nextTrigger the next cue in the focused presentation
trigger_focused_presentationTrigger the currently focused presentation
trigger_focused_previousTrigger the previous slide in the focused presentation
trigger_next_slideTrigger the next cue in the current presentation
trigger_presentationTrigger a specific presentation by UUID, optionally starting at a specific slide index
trigger_presentation_cueTrigger a specific cue by index in a presentation by UUID
trigger_previous_slideTrigger the previous cue in the current presentation
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan171 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 94 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Propresenter compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- Tools
- 100
- the typical server has 7
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 13
- more than 89% of 28,688 servers
- Downloads a week
- 33
- more than 22% of 12,191 servers with a package
What its tools let an agent do: 81 read · 3 change · 7 send or post · 9 run or deploy
Install Propresenter in Claude Code, Cursor or VS Code
Runs npx -y @alxpark/propresenter-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add propresenter-mcp -- npx -y @alxpark/propresenter-mcp
What the publisher says
From the Propresenter repository's README, as published. We do not edit it. Read it on GitHub
propresenter-mcp
A comprehensive Model Context Protocol (MCP) server that provides complete control over ProPresenter presentations via the ProPresenter API. This server implements the full ProPresenter API specification with 231 endpoints organized into 27 API groups and exposed through modular client classes.
Official MCP Registry
- https://registry.modelcontextprotocol.io/?q=alxpark%2Fpropresenter-mcp
Prerequisites
- Node.js 18 or higher
- ProPresenter 7 with API enabled
- ProPresenter running and accessible on your network
Installation
- Clone this repository or download the source code
- Install dependencies:
npm install- Build the project:
npm run buildConfiguration
The server connects to ProPresenter using environment variables:
- PROPRESENTER_URL - The URL of your ProPresenter instance (default: http://localhost:50000)
- PROPRESENTER_PASSWORD - The API password (if configured in ProPresenter)
ProPresenter Setup
- Open ProPresenter preferences
- Go to the Network tab
- Enable "Network" and note the port number (default: 50000)
- Optionally set a password for API access
Usage
With Claude Desktop
Add this to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json
{
"mcpServers": {
"propresenter": {
"command": "node",
"args": ["/absolute/path/to/propresenter-mcp/build/index.js"],
"env": {
"PROPRESENTER_URL": "http://localhost:50000",
"PROPRESENTER_PASSWORD": "your-password-if-needed"
}
}
}
}Replace /absolute/path/to/propresenter-mcp with the actual path to this project.
With VS Code
This server can be debugged directly in VS Code using the included MCP configuration.
- Open this project in VS Code
- The server is automatically configured for debugging via .vscode/mcp.json
- Use the MCP extension to test and debug the server
Example Commands
Once connected, you can ask Claude to control ProPresenter:
Status & Information:
- "What version of ProPresenter is running?"
- "Show me the status of all screens"
- "What's the status of audience screens?"
- "Get the current slide information"
Presentations:
- "What presentation is currently active?"
- "Trigger the presentation with UUID [uuid]"
- "Go to the next slide"
- "Go to slide number 5"
- "Play the presentation timeline"
- "Show me the chord chart"
- "Get a thumbnail of slide 3"
Announcements:
- "What announcement is currently active?"
- "Trigger the next announcement cue"
- "Show me the announcement timeline status"
- "Go to announcement cue 2"
Audio & Media:
- "List all audio playlists"
- "Show me the contents of audio playlist [id]"
- "Play the next song in the active playlist"
- "Trigger the focused audio playlist"
- "List all media playlists"
- "Trigger media item [id] in playlist [playlist_id]"
Playlists:
- "List all presentation playlists"
- "Show me the active playlist"
- "Focus the next playlist"
- "Trigger the first item in the focused playlist"
- "Create a new playlist called 'Sunday Service'"
Capture:
- "What's the current capture status?"
- "Start recording"
- "Stop the capture"
- "Show me available capture encodings for RTMP"
Clear:
- "Clear the announcements layer"
- "Show me all clear groups"
- "Trigger the clear group [id]"
- "Create a new clear group"
Library:
- "List all my libraries"
- "Show presentations in library [id]"
- "Trigger presentation [id] from library [library_id]"
Looks:
- "Show me all configured looks"
- "What look is currently live?"
- "Switch to look [id]"
- "Create a new look"
Macros:
- "List all macros"
- "Trigger macro [id]"
- "Show me all macro collections"
- "Create a new macro"
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Propresenter: common questions
- Is Propresenter MCP server safe?
- Mostly: it is graded B (72/100). Read the Propresenter safety report
- How do I install Propresenter?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Propresenter need an API key?
- Yes. The registry entry asks for
PROPRESENTER_PASSWORD. - Is Propresenter maintained?
- The last commit was 131 days ago (2026-06-26). The latest release is v1.0.1.
- How does Propresenter compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); tools 100 (the typical server has 7); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.