Skip to content
Back to search

powerpoint-mcp

Open Source Model Context Protocol server for PowerPoint automation on Windows via pywin32

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ayushmaniar--powerpoint-mcp/badge.svg)](/listings/ayushmaniar--powerpoint-mcp)

HTML

<a href="/listings/ayushmaniar--powerpoint-mcp"><img src="/api/listings/ayushmaniar--powerpoint-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Step 1: Install**

claude mcp add powerpoint -- uvx powerpoint-mcp

**Step 2: Open PowerPoint** Open Microsoft PowerPoint (any presentation, or just the blank start screen).

**Step 3: Give Claude a command**

Make a 10-slide presentation on machine learning fundamentals using my company template.
Add equations where relevant and animate the bullet points on each slide.

That is it. Claude handles the rest.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 348 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # PowerPoint MCP Server
  2. The best open-source MCP server for PowerPoint automation. Free, no subscriptions, no credits.
  3. Built by a UCSD grad student who was tired of spending 3-4 hours per week making presentations.
  4. **Languages**
  5. - [English](#powerpoint-mcp-server)
  6. - [中文](README.zh-CN.md)
  7. - [日本語](README.ja.md)
  8. [![PyPI version](https://badge.fury.io/py/powerpoint-mcp.svg)](https://badge.fury.io/py/powerpoint-mcp)
  9. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  10. [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
  11. ---
  12. ## Demo Video
  13. [![Watch the PowerPoint MCP Demo](video_thumbnail.jpg)](https://www.youtube.com/watch?v=5p24Vr36py8)
  14. *Watch Claude build a complete "Fourier Transform and Fourier Series" lecture from scratch - equations, diagrams, and animations included.*
  15. ---
  16. ## Windows Only
  17. **This MCP server works exclusively on Windows** because it uses `pywin32` COM automation to control the PowerPoint application directly. This is what enables bidirectional read/write access, real-time editing, LaTeX rendering, templates, and animations.
  18. macOS/Linux alternatives like `python-pptx` don't get access to the full PowerPoint feature set. PRs for an AppleScript-based macOS version are welcome.
  19. ---
  20. ## Why This Is Different
  21. There are a lot of PowerPoint automation tools out there. Here is why this one is actually worth using:
  22. **Template-first design**
  23. Point the LLM at your desired template and it just works. Tell Claude: *"Make a GPU performance comparison presentation using our company's Nvidia_Black_Green_2025 template"* - it discovers the template, analyzes its layouts, and populates them correctly.
  24. **Actually bidirectional and real-time**
  25. Unlike `python-pptx` (write-only) or other popular MCP implementations, this uses COM automation. Claude can READ your existing presentations and edit them in real time without closing PowerPoint first.
  26. **Multimodal slide analysis**
  27. The `slide_snapshot` tool gives the LLM both visual context (screenshots with annotated bounding boxes) AND detailed text/chart/table extraction. Claude can literally see what is on your slides.
  28. **LaTeX rendering that actually works**
  29. The server renders LaTeX equations by controlling PowerPoint's built-in equation editor directly. Just write `<latex>E=mc^2</latex>` and it appears as a native PowerPoint equation object.
  30. **HTML formatting that saves tokens**
  31. Bold, italic, colors, and bullet points via HTML tags (`<b>`, `<i>`, `<red>`, `<ul>`, `<ol>`). One formatting pass, no repeated tool calls to apply fonts and colors separately.
  32. **Animations with progressive disclosure**
  33. Real controllable PowerPoint animations, including paragraph-level entrance effects. Bullet-by-bullet reveals work out of the box - no need to split content across multiple shapes.
  34. **One-line install, no subscriptions**
  35. ```bash
  36. claude mcp add powerpoint -- uvx powerpoint-mcp
  37. ```
  38. Works with Claude Code, Cursor, GitHub Copilot, or any MCP client. No third-party services, no monthly fees, no expiring credits.
  39. **11 focused tools, not 30+**
  40. LLM decision paralysis is real. Every tool has a clear purpose and sensible defaults so Claude spends time building your presentation, not figuring out which tool to call.
  41. ---
  42. ## Real Workflows
  43. These are actual workflows tested in production:
  44. **Research and Create**
  45. > "Research the latest developments in quantum computing, then create a 15-slide presentation on it"
  46. Claude uses web search to find sources, then builds the deck with citations and formatted content.
  47. **Data Analysis and Visualization**
  48. > "Analyze Titanic_dataset.csv, perform a detailed EDA, and make a presentation explaining the findings"
  49. Free-form Python/matplotlib plotting that renders directly into slide placeholders.
  50. **Codebase Documentation**
  51. > "Analyze my entire repository and create a technical architecture presentation"
  52. Claude reads your local files, understands the structure, and generates slides explaining the system.
  53. **Template-Driven Corporate Decks**
  54. > "Use the Nvidia_Black_Green_template to create a Q4 sales presentation from nvidia_quarterly_sales_data.csv"
  55. Template layouts are discovered automatically, placeholders are identified and populated correctly.
  56. **Academic LaTeX Heavy**
  57. > "Make a 20-slide lecture teaching Fourier Series and Fourier Transforms with equations"
  58. Native PowerPoint equation objects rendered from LaTeX, with animations for progressive disclosure.
  59. **Interactive Learning**
  60. > "Help me understand this presentation on PAM and BLOSUM matrices from my Computational Biology course, explain each slide and quiz me after each section"
  61. Claude reads your slides (including charts, tables, and speaker notes), explains the content, and creates an interactive quiz.
  62. ---
  63. ## Quick Start
  64. **Step 1: Install**
  65. ```bash
  66. claude mcp add powerpoint -- uvx powerpoint-mcp
  67. ```
  68. **Step 2: Open PowerPoint**
  69. Open Microsoft PowerPoint (any presentation, or just the blank start screen).
  70. **Step 3: Give Claude a command**
  71. ```
  72. Make a 10-slide presentation on machine learning fundamentals using my company template.
  73. Add equations where relevant and animate the bullet points on each slide.
  74. ```
  75. That is it. Claude handles the rest.
  76. ---
  77. ## Installation
  78. ### Prerequisites
  79. - Windows 10/11
  80. - Microsoft PowerPoint installed
  81. - Python 3.10+
  82. ### Claude Code
  83. ```bash
  84. # Single project
  85. claude mcp add powerpoint -- uvx powerpoint-mcp
  86. # Available across all projects (install once, use everywhere)
  87. claude mcp add powerpoint --scope user -- uvx powerpoint-mcp
  88. ```
  89. ### Cursor
  90. 1. Click Settings -> Tools & MCP -> New MCP Server
  91. 2. `~/.cursor/mcp.json` will open
  92. 3. Add the following:
  93. ```json
  94. {
  95. "mcpServers": {
  96. "powerpoint": {
  97. "command": "uvx",
  98. "args": ["powerpoint-mcp"]
  99. }
  100. }
  101. }
  102. ```
  103. 4. Restart your IDE after configuration.
  104. ### Trae
  105. 1. Create `.trae/mcp.json` in your project root
  106. 2. Add the following:
  107. ```json
  108. {
  109. "mcpServers": {
  110. "powerpoint": {
  111. "command": "uvx",
  112. "args": ["powerpoint-mcp"]
  113. }
  114. }
  115. }
  116. ```
  117. 3. Restart Trae after configuration and use an MCP-enabled agent mode
  118. ### Trae CN
  119. 1. Trae CN currently supports the same project-level `.trae/mcp.json` format
  120. 2. Add the following to `.trae/mcp.json` in your project root:
  121. ```json
  122. {
  123. "mcpServers": {
  124. "powerpoint": {
  125. "command": "uvx",
  126. "args": ["powerpoint-mcp"]
  127. }
  128. }
  129. }
  130. ```
  131. 3. Restart Trae CN after configuration and use an MCP-enabled agent mode such as Builder with MCP / SOLO Coder if available in your build
  132. ### Codex
  133. This server is Windows-only, so on Windows PowerShell use:
  134. ```bash
  135. codex mcp add powerpoint -- cmd /c uvx powerpoint-mcp
  136. ```
  137. After adding it, restart Codex CLI or run `/mcp` to verify the server is available.
  138. ### CodeBuddy
  139. 1. In the sidebar chat panel, click the CodeBuddy Settings button
  140. 2. Open the MCP tab
  141. 3. Click Add MCP
  142. 4. Add the following JSON:
  143. ```json
  144. {
  145. "mcpServers": {
  146. "powerpoint": {
  147. "type": "stdio",
  148. "command": "uvx",
  149. "args": ["powerpoint-mcp"],
  150. "description": "PowerPoint automation on Windows"
  151. }
  152. }
  153. }
  154. ```
  155. 5. Save the configuration, then use Try to Run or invoke it from an agent
  156. ### CodeBuddy CN
  157. 1. 在侧栏对话面板右上方点击 CodeBuddy Settings
  158. 2. 切换到 MCP 标签页
  159. 3. 点击 Add MCP
  160. 4. 添加以下 JSON:
  161. ```json
  162. {
  163. "mcpServers": {
  164. "powerpoint": {
  165. "type": "stdio",
  166. "command": "uvx",
  167. "args": ["powerpoint-mcp"],
  168. "description": "PowerPoint automation on Windows"
  169. }
  170. }
  171. }
  172. ```
  173. 5. 保存配置后,可通过 Try to Run 验证,或直接在 Agent 中调用
  174. ### OpenCode
  175. 1. Open `~/.config/opencode/opencode.json` for a global setup, or `opencode.json` in your project root for a project-specific setup
  176. 2. Add the following:
  177. ```json
  178. {
  179. "$schema": "https://opencode.ai/config.json",
  180. "mcp": {
  181. "powerpoint": {
  182. "type": "local",
  183. "command": ["uvx", "powerpoint-mcp"]
  184. }
  185. }
  186. }
  187. ```
  188. 3. Restart OpenCode after configuration.
  189. ### VS Code (GitHub Copilot)
  190. 1. Open `C:\Users\Your_User_Name\AppData\Roaming\Code\User\mcp.json`
  191. 2. Add the following:
  192. ```json
  193. {
  194. "mcpServers": {
  195. "powerpoint": {
  196. "command": "uvx",
  197. "args": ["powerpoint-mcp"]
  198. }
  199. }
  200. }
  201. ```
  202. 3. Restart your IDE after configuration.
  203. ### Google Antigravity
  204. 1. Open an Agent session in Antigravity
  205. 2. Click the **"..."** (dot menu) at the top of the editor's side panel
  206. 3. Select **MCP Servers** → **Manage MCP Servers** → **View raw config**
  207. - This opens `mcp_config.json` directly. You can also edit it manually at:
  208. - Windows: `C:\Users\<USERNAME>\.gemini\antigravity\mcp_config.json`
  209. - macOS / Linux: `~/.gemini/antigravity/mcp_config.json`
  210. 4. Add the following:
  211. ```json
  212. {
  213. "mcpServers": {
  214. "powerpoint": {
  215. "command": "uvx",
  216. "args": ["powerpoint-mcp"]
  217. }
  218. }
  219. }
  220. ```
  221. 5. Return to **Manage MCP Servers** and click **Refresh** to activate the server.
  222. ---
  223. ## Tool Reference
  224. All 11 tools, each with a single clear responsibility:
  225. | Tool | What It Does |
  226. |------|-------------|
  227. | `manage_presentation` | Open, close, create, or save presentations. The entry point for any workflow. |
  228. | `slide_snapshot` | Comprehensive slide analysis: screenshot with annotated bounding boxes, text extraction, chart data, table parsing, hyperlinks, comments, and speaker notes. |
  229. | `switch_slide` | Navigate to a specific slide number in the active presentation. |
  230. | `add_speaker_notes` | Add or replace speaker notes on any slide using the official COM approach. |
  231. | `populate_placeholder` | Fill any placeholder with text (HTML formatting), LaTeX equations, or matplotlib plots. |
  232. | `manage_slide` | Duplicate, delete, or move slides within the presentation. |
  233. | `list_templates` | Discover all available PowerPoint templates from Personal, User, and System template directories. |
  234. | `analyze_template` | Analyze a template's layouts with placeholder positions and screenshots. |
  235. | `add_slide_with_layout` | Add a new slide using a specific layout from a template, preserving all template styling. |
  236. | `add_animation` | Add entrance animations (fade, appear, fly, wipe, zoom) to shapes with optional paragraph-level progressive disclosure. |
  237. | `powerpoint_evaluate` | Execute arbitrary Python code in the PowerPoint context for complex batch operations. |
  238. ---
  239. ## Content Formatting Reference
  240. The `populate_placeholder` tool accepts HTML-style tags for rich formatting:
  241. ```
  242. <b>bold text</b>
  243. <i>italic text</i>
  244. <u>underlined text</u>
  245. <red>colored text</red> (also: blue, green, orange, purple, white, black)
  246. <ul><li>unordered list item</li></ul>
  247. <ol><li>ordered list item</li></ol>
  248. <latex>E = mc^2</latex>
  249. ```
  250. For matplotlib plots, pass your plotting code directly as the content with `content_type="plot"` - the server executes it and inserts the resulting image.
  251. ---
  252. ## How It Works
  253. PowerPoint MCP uses Windows COM automation (`pywin32`) to control Microsoft PowerPoint directly, the same mechanism used by VBA macros and Office add-ins. This gives it full access to every PowerPoint feature: the equation editor, animation engine, template system, and real-time slide reading.
  254. The server is built on [FastMCP](https://github.com/jlowin/fastmcp) and published on [PyPI](https://pypi.org/project/powerpoint-mcp/) for easy installation via `uvx`.
  255. Screenshots are saved automatically to `~/.powerpoint-mcp/` with timestamp-based filenames.
  256. ---
  257. ## Limitations
  258. - **Windows only**: COM automation is a Windows technology. No macOS or Linux support currently.
  259. - **PowerPoint required**: Microsoft PowerPoint must be installed. LibreOffice is not supported.
  260. - **Python 3.10+**: Required for the server runtime.
  261. ---
  262. ## Star History
  263. [![Star History Chart](https://api.star-history.com/svg?repos=ayushmaniar/powerpoint-mcp&type=date&legend=top-left)](https://www.star-history.com/#ayushmaniar/powerpoint-mcp&type=date&legend=top-left)
  264. ---
  265. Fully open source (MIT License). If this saves you time, a star on GitHub goes a long way.
  266. **GitHub:** https://github.com/Ayushmaniar/powerpoint-mcp

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.