
Propresenter Mcp
io.github.alxparkPublished by GitHub account alxparkv1.0.1Updated Oct 24, 2026
ProPresenter 7 MCP server
Overview
A local MCP server that lets an assistant control ProPresenter 7 over its REST API — presentations, playlists, audio, media, timers, messages, looks and capture
- What you can do
- Inspect status and information: version, screen status, current slide, system time, capture status and encodings, masks and themes with slide details, stage layouts and current stage message, and current look or active playlist and presentation. Control presentations and slides: trigger a presentation by UUID, go to next or a numbered slide, play the timeline, fetch chord charts and slide thumbnails, and play, pause, skip or seek layers. Manage playlists, libraries, audio and media: list and focus playlists, trigger items, play the next song, list libraries and trigger presentations from them, and trigger media items. Operate announcements, looks, macros, props, messages, timers and triggers
- When to use it
- Useful when you run ProPresenter 7 for live services or events and want to drive it conversationally from an assistant — checking what is live, advancing slides, starting timers or capture, or showing stage messages — instead of clicking through the app.
- Requirements
- Node.js 18 or higher and a local build of the package; ProPresenter 7 running with its Network API enabled and reachable on your network. Set PROPRESENTER_URL (default and, if API access is password-protected, PROPRESENTER_PASSWORD. Desktop only.
Installation
In SourceWeft
- Open Propresenter Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
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
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:
- Build the project:
Configuration
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/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
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"
Props:
- "List all props"
- "Trigger prop [id]"
- "Clear prop [id]"
- "Pause auto-clear for prop [id]"
- "List all prop collections"
Stage:
- "Show me the current stage message"
- "Display stage message [message]"
- "Hide the stage message"
- "List all stage layouts"
- "Set stage layout [layout_id] for screen [screen_id]"
Messages:
- "Show me all messages"
- "Display message [id]"
- "Hide message [id]"
- "Create a new message"
Timers:
- "List all timers"
- "Start timer [id]"
- "Stop timer [id]"
- "Reset the sermon timer"
- "Create a countdown timer"
- "Get the current system time"
Themes:
- "List all themes"
- "Show me details of theme [id]"
- "Get theme slide [slide_id] from theme [theme_id]"
Transport:
- "Play the presentation layer"
- "Pause the audio layer"
- "Skip forward 30 seconds on the announcement layer"
- "Go to the end of the presentation"
- "Get the current playback time"
Masks:
- "List all masks"
- "Show me details of mask [id]"
Triggers:
- "Trigger the next cue"
- "Trigger the previous media item"
Development
Build
Watch Mode
API Reference
This server implements the complete ProPresenter API documented at https://openapi.propresenter.com/
API Coverage
- Total Endpoints: 231 REST API endpoints
- API Groups: 27 functional groups
- Client Modules: 18 TypeScript client classes
- Tool Definitions: 18 MCP tool modules
- Handler Modules: 18 request handler modules
- HTTP Methods: Full support for GET, POST, PUT, DELETE operations
- Architecture: Complete three-layer implementation (clients → tools → handlers)
See api/api.md for complete API documentation with all 231 endpoints organized by group.
Troubleshooting
Connection Issues:
- Verify ProPresenter is running and the API is enabled
- Check that the URL and port are correct
- Ensure no firewall is blocking the connection
- Verify the password if authentication is enabled
Server Not Starting:
- Make sure you've built the project with
npm run build - Check that Node.js 18+ is installed
- Verify all dependencies are installed with
npm install
Source: README.md at commit 31832fe
Tools
0Version history
1- v1.0.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts