PptxBLOCK
Create Slides with a simple MCP server using Python PPTX library
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A FastMCP-powered server for programmatically creating, editing, and rendering PowerPoint (PPTX) presentations. Supports slide creation, text and shape insertion, image embedding, and slide rendering to PNG (with LibreOffice).
Features
- Create/Clear Presentations: Start new or reset existing PPTX files.
- Add Slides: Insert slides with customizable layouts.
- Text & Content: Add titles, content, and custom textboxes to slides.
- Shapes: Insert a wide variety of PowerPoint shapes (including flowchart elements).
- Images: Embed images into slides.
- Slide Description: Get a textual summary of slide contents for verification.
- Slide Rendering: Render slides as PNG images (requires LibreOffice).
- Download PPTX: Download the generated presentation file.
Requirements
- Python 3.12+
- python-pptx
- Pillow
- FastMCP
- LibreOffice (for slide image rendering; must be installed separately and available in your system PATH)
- python-dotenv (for development environment configuration)
Installation
- Install Python dependencies:
pip install .
(Installs from `pyproject.toml` for dependencies)
- Optional: Install python-dotenv for development environment variables:
pip install python-dotenv
- Install LibreOffice (for image rendering):
- Linux:
sudo pacman -S libreoffice-freshorsudo apt install libreoffice - macOS:
brew install --cask libreoffice - Windows: Download from libreoffice.org
Usage
Start the server:
python server.py
For development with environment variables:
You can set the server's host and port using environment variables:
HOST(default:127.0.0.1)PORT(default:8000)
For example, to run on all
e2394eb8d554OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add pptx-mcp-server -- uvx pptx-mcp-server
{
"mcpServers": {
"pptx-mcp-server": {
"command": "uvx",
"args": [
"pptx-mcp-server"
]
}
}
}Exposed tools (11)
1 read · 8 write · 2 destructive. Blast radius: 2 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
add_connector | write | |
add_picture | write | |
add_shape | write | |
add_slide | write | |
add_textbox | write | |
add_title_and_content | write | |
batch_update | write | |
create_or_clear_presentation | destructive | |
delete_shape | destructive | |
get_presentation_file_b64 | read | |
modify_shape | write |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | FAIL |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- found
Findings (7)
.env
mcp_server_url = "http://127.0.0.1:8000/sse"
create_or_clear_presentation, delete_shape
sse
.env
image_bytes = base64.b64decode(image_base64)
Load the environment variables when starting the server:
Gates applied: no_behavioural_pass.
e2394eb8d554full audit observations/trust-audit/mcp-server/samos123__pptx-2.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | e2394eb8d554 | BLOCK | D | 69 | first audit |
Questions
What is the Pptx MCP server?
Create Slides with a simple MCP server using Python PPTX library
What tools does Pptx expose?
11 in total: 1 read-only, 8 that write, and 2 that can delete or overwrite (create_or_clear_presentation, delete_shape). Every one is listed on this page with its risk.
Is Pptx safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on. Separately from the audit: 2 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does Pptx need?
No credential environment variables were found in its source, so it appears to need none.
How does Pptx run?
It speaks sse, so it runs as a service you connect to over the network. It is published on PyPI as pptx-mcp-server.
How current is this page?
The grade is for one exact copy of the source (e2394eb8d554), read on 2026-10-08. The repository is watched and re-audited when it changes.