# Propresenter MCP

> Propresenter MCP is an open-source MCP server for agent tooling. MCP server giving AI clients control over ProPresenter 7 slides, timers and playlists. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI, API, self-hosted
- **Repository:** https://github.com/alxpark/propresenter-mcp
- **MCP Registry name:** io.github.alxpark/propresenter-mcp
- **Categories:** [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-18

## About

The README describes this as an MCP server that wraps the ProPresenter 7 network API, covering a large share of its endpoints across status, presentations, audio and media playlists, capture, clears, looks, macros, props, stage displays, messages, timers, themes and transport controls. Once connected, an AI client can trigger slides, start or stop timers, switch looks and start or stop recording through natural-language requests.

Setup is done with Node.js 18 or newer. The user enables the Network option in ProPresenter's preferences, notes the port (50000 by default), optionally sets an API password, and then points the server at that URL through environment variables. The package is also published on npm and in the official MCP registry, and it can be added to Claude Desktop or debugged in VS Code.

It suits worship and event technicians or developers who want to drive ProPresenter from an AI assistant or scripted workflow rather than from the operator console. The README lists a connection troubleshooting section covering the API being enabled, the port, firewalls and the password.

## Features

- **Broad API coverage:** Exposes ProPresenter 7 API endpoints grouped into 27 functional areas, according to the README.
- **Slide and playlist control:** Triggers presentations, moves between slides and playlist items, and creates new playlists.
- **Timers and stage messages:** Starts, stops and resets timers and shows or hides stage display messages.
- **Looks, macros and props:** Switches looks, runs macros and triggers or clears props from the assistant.
- **Capture and audio playback:** Checks capture status, starts or stops recording and controls audio playlists.
- **Environment-based configuration:** Connects using a URL and optional password supplied as environment variables.

## Good for

- Advancing slides for a live service from an AI assistant
- Starting and resetting sermon or countdown timers during an event
- Switching looks or triggering props and macros by voice or text request
- Scripting ProPresenter operations as part of an automated production workflow
- Starting or stopping recording and RTMP capture from a chat interface

## Install

### Claude Code (Terminal)

```sh
claude mcp add propresenter-mcp --env PROPRESENTER_URL='<PROPRESENTER_URL>' --env PROPRESENTER_PASSWORD='<PROPRESENTER_PASSWORD>' -- npx -y @alxpark/propresenter-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "propresenter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alxpark/propresenter-mcp"
      ],
      "env": {
        "PROPRESENTER_URL": "<PROPRESENTER_URL>",
        "PROPRESENTER_PASSWORD": "<PROPRESENTER_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "propresenter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alxpark/propresenter-mcp"
      ],
      "env": {
        "PROPRESENTER_URL": "<PROPRESENTER_URL>",
        "PROPRESENTER_PASSWORD": "<PROPRESENTER_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "propresenter-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@alxpark/propresenter-mcp"
      ],
      "env": {
        "PROPRESENTER_URL": "<PROPRESENTER_URL>",
        "PROPRESENTER_PASSWORD": "<PROPRESENTER_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "propresenter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alxpark/propresenter-mcp"
      ],
      "env": {
        "PROPRESENTER_URL": "<PROPRESENTER_URL>",
        "PROPRESENTER_PASSWORD": "<PROPRESENTER_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "propresenter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alxpark/propresenter-mcp"
      ],
      "env": {
        "PROPRESENTER_URL": "<PROPRESENTER_URL>",
        "PROPRESENTER_PASSWORD": "<PROPRESENTER_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### What do I need to run it?

The README lists Node.js 18 or higher, ProPresenter 7 with its API enabled, and network access to the ProPresenter machine.

### How is it configured?

Through the PROPRESENTER_URL environment variable (default http://localhost:50000) and an optional PROPRESENTER_PASSWORD if an API password is set in ProPresenter.

### Which AI clients can use it?

The README gives setup instructions for Claude Desktop and VS Code, and the registry entry lists it as a stdio server.

### Is Propresenter MCP free?

Yes. Propresenter MCP is open source, so you can use and self-host it for free.

### How do I add Propresenter MCP to Claude Code?

Run this command in your terminal: claude mcp add propresenter-mcp --env PROPRESENTER_URL='<PROPRESENTER_URL>' --env PROPRESENTER_PASSWORD='<PROPRESENTER_PASSWORD>' -- npx -y @alxpark/propresenter-mcp

### What are the best alternatives to Propresenter MCP?

The closest alternatives to Propresenter MCP are toolhive, mcp-gateway-registry, Z-Image MCP, Meigen AI MCP and Seedance 2.0 MCP.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [toolhive](https://ai-powered.com/mcp/toolhive): toolhive is an open-source MCP server for agent tooling.
- [mcp-gateway-registry](https://ai-powered.com/mcp/mcp-gateway-registry): mcp-gateway-registry is an open-source MCP server for agent tooling.
- [Z-Image MCP](https://ai-powered.com/mcp/z-image-mcp): Z-Image MCP is a freemium MCP server for design and media.
- [Meigen AI MCP](https://ai-powered.com/mcp/meigen-ai-mcp): Meigen AI MCP is an open-source MCP server for design and media.
- [Seedance 2.0 MCP](https://ai-powered.com/mcp/seedance-2-0-mcp): Seedance 2.0 MCP is an open-source MCP server for design and media.
- [Synapbus](https://ai-powered.com/mcp/synapbus): Synapbus is an open-source MCP server for agent tooling.
- [Hive Connector](https://ai-powered.com/mcp/hive-connector): Hive Connector is a freemium MCP server for agent tooling.
- [Tiramisu AI MCP](https://ai-powered.com/mcp/tiramisu-ai-mcp): Tiramisu AI MCP is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/propresenter-mcp
