The PPT-MCP server provides a pure Node.js solution for comprehensive PowerPoint presentation management with AI-powered workflows through Claude integration.
Create presentations with customizable titles, slide counts, output paths, and template styles (basic, professional, modern)
Edit existing presentations by adding slides, text, images, or tables with precise positioning options
Read and extract content from PowerPoint files in text, JSON, or markdown format with optional slide ranges and speaker notes
Analyze presentations for structure, content, statistics, readability, or comprehensive insights with detailed reporting
AI-powered workflows supporting natural language commands, intelligent template suggestions, and batch operations
Cross-platform compatibility with custom file management using pure Node.js/TypeScript
🎯 PPT-MCP
Pure Node.js PowerPoint MCP Server - Create, analyze, and manage PowerPoint presentations with AI assistance
1 PPT-MCP is a Model Context Protocol (MCP) server that provides comprehensive PowerPoint presentation management capabilities using pure JavaScript/TypeScript. Built with PptxGenJS, the most popular PowerPoint library for Node.js with 3,500+ GitHub stars.
✨ Features
🚀 Pure Node.js Stack
Zero Python Dependencies - 100% JavaScript/TypeScript implementation
Cross-Platform - Works on Windows, macOS, and Linux
Modern Architecture - Built with latest Node.js and TypeScript
Lightweight - Minimal dependencies, fast startup
📊 Core Capabilities
🎨 Create Presentations - Generate professional PowerPoint files with custom templates
✏️ Edit Existing Files - Advanced editing capabilities with pptx-automizer for real PowerPoint modification
📖 File Analysis - Analyze presentation structure and metadata
🔧 Template Support - Basic, Professional, and Modern design templates
📁 File Management - Smart file handling and directory management
🎯 AI-Powered Workflow
Claude Integration - Seamless integration with Claude Desktop
Natural Language - Create presentations using conversational commands
Intelligent Templates - AI-suggested layouts and designs
Batch Operations - Handle multiple presentations efficiently
🚀 Quick Start
Prerequisites
Node.js 18+
Claude Desktop (for MCP integration)
Installation
Option 1: NPM Package (Recommended)
Option 2: From Source
Claude Desktop Configuration
Add to your Claude Desktop config:
Stdio Mode (Local Development)
SSE Mode (Production)
🛠️ Available Tools
1. create_presentation
Create new PowerPoint presentations with customizable options.
Parameters:
title
(required) - Presentation titleslides
(optional) - Number of slides (default: 1)output_path
(optional) - Custom save locationtemplate
(optional) - Design template:basic
,professional
,modern
Example:
2. edit_presentation
Basic editing of existing presentations (Note: Limited by PptxGenJS library capabilities).
Parameters:
file_path
(required) - Path to existing presentationoperation
(required) - Edit type:add_slide
,add_text
,add_image
,add_table
slide_index
(optional) - Target slide numbercontent
(optional) - Content to add
2.5. edit_presentation_enhanced 🆕
Enhanced PowerPoint editing with comprehensive guidance and step-by-step instructions for manual editing.
Parameters:
file_path
(required) - Path to existing presentationoperation
(required) - Operation type:get_guidance
,add_slide
,replace_text
,extract_content
slide_index
(optional) - Target slide number (1-based)content
(optional) - Content specifications
Features:
📋 Step-by-step editing instructions
🔧 Multiple solution approaches
💡 Best practice recommendations
🎯 Operation-specific guidance
Example:
3. read_presentation
Analyze and extract information from PowerPoint files.
Parameters:
file_path
(required) - Path to presentation fileoutput_format
(optional) - Format:text
,json
,markdown
slide_range
(optional) - Specific slides to readinclude_notes
(optional) - Include speaker notes
4. analyze_presentation
Perform comprehensive analysis of presentation structure and content.
Parameters:
file_path
(required) - Path to presentation fileanalysis_type
(optional) - Analysis type:structure
,content
,statistics
,readability
,comprehensive
detailed
(optional) - Enable detailed analysis
📁 Project Structure
🔧 Development
Build Commands
Testing
🎨 Template Showcase
Basic Template
Clean, minimal design
Black text on white background
Perfect for academic or simple business presentations
Professional Template
Corporate color scheme (Dark Slate Gray)
Sophisticated typography
Ideal for business meetings and reports
Modern Template
Vibrant blue and green accents
Contemporary design elements
Great for creative and tech presentations
🚀 Technology Stack
Runtime: Node.js 18+
Language: TypeScript
PPT Engine: 1 PptxGenJS (3,500+ ⭐)
MCP SDK: @modelcontextprotocol/sdk
Build System: TypeScript Compiler
Package Manager: NPM
🔄 Migration from Python
This version represents a complete rewrite from Python to pure Node.js:
Advantages of Node.js Version:
✅ Faster Startup - No Python interpreter overhead
✅ Simpler Deployment - Single runtime environment
✅ Better Integration - Native JavaScript ecosystem
✅ Modern Tooling - TypeScript, ESM, and modern Node.js features
✅ Cross-Platform - Consistent behavior across operating systems
Current Limitations:
⚠️ Direct File Modification - PptxGenJS is creation-focused, not editing-focused
⚠️ Complex Animations - Advanced animations not yet supported
⚠️ Embedded Media - Video/audio embedding requires additional implementation
Solutions Provided:
✅ Comprehensive Guidance -
edit_presentation_enhanced
tool provides step-by-step instructions✅ Multiple Approaches - Manual editing, hybrid workflows, and programmatic creation
✅ Best Practices - Detailed recommendations for different editing scenarios
The
🤝 Contributing
We welcome contributions! Here's how to get started:
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-feature
Commit your changes:
git commit -m 'Add amazing feature'
Push to the branch:
git push origin feature/amazing-feature
Open a Pull Request
Development Guidelines
Follow TypeScript best practices
Add tests for new features
Update documentation
Ensure cross-platform compatibility
📄 License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
👨💻 Author
Xingyu Chen
🌐 LinkedIn: Xingyu Chen
📧 Email: guangxiangdebizi@gmail.com
🐙 GitHub: @guangxiangdebizi
📦 NPM: @xingyuchen
🙏 Acknowledgments
PptxGenJS Team - For the excellent PowerPoint generation library
Anthropic - For the Model Context Protocol specification
TypeScript Team - For the amazing type system
Node.js Community - For the robust runtime environment
⭐ Star this repo if you find it helpful!
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables creating, analyzing, and managing PowerPoint presentations using pure Node.js. Supports generating professional presentations with custom templates, reading existing files, and performing content analysis through natural language commands.