notebookLM2PPT MCP Server

Convert PDF Slides to PowerPoint Presentations with Vector Graphics

README.md

English | 简体中文 | 繁體中文 | 日本語

notebookLM2PPT

Convert PDF Slides to PowerPoint Presentations with Vector Graphics (highest resolution).

notebookLM2PPT Web UI

✨ Features

  • 🎯 Vector Graphics - Maintains highest resolution in generated PPT
  • 📝 Metadata Conversion - Preserves title, author and other metadata
  • 📐 Auto Detection - Automatically detects slide size and aspect ratio
  • 🚀 Easy to Use - Simple command line interface with beautiful output
  • 📄 Page Selection - Convert specific pages with --pages option
  • Parallel Processing - Speed up conversion with --parallel option
  • 🔍 Dependency Check - Automatically checks for required tools
  • 🎨 Web UI - Modern web interface with drag-and-drop support
  • 📡 REST API - FastAPI server with async processing
  • 🔧 MCP Support - Model Context Protocol for AI integration
  • 🐳 Docker Ready - All-in-one Docker image available
  • 💎 Glassmorphism Design - Ultra modern frosted glass UI with neon effects
  • 🌍 18 Languages - Full internationalization support

🌍 Supported Languages

Language Code Language Code
English en Italiano it
简体中文 zh-CN Русский ru
繁體中文 zh-TW العربية ar
日本語 ja हिन्दी hi
한국어 ko ไทย th
Français fr Tiếng Việt vi
Deutsch de Nederlands nl
Español es Polski pl
Português pt Türkçe tr

🎯 Motivation

  • LaTeX users can easily convert `beamer` slides from PDF to PPT
  • Typst users can easily convert `touying` slides from PDF to PPT

🚀 Quick Start

Option 1: Command Line (pipx)

# Install via pipx (recommended)
pipx install notebooklm2ppt

# Convert PDF to PPT
pdf2ppt input.pdf output.pptx

Option 2: Web UI (Docker)

For x86_64 / AMD64 (Linux servers, Intel Macs):

docker run -d -p 8100:8100 neosun/notebooklm2ppt:1.2.0-amd64

For ARM64 (Apple Silicon Macs, ARM servers):

docker run -d -p 8100:8100 neosun/notebooklm2ppt:1.2.0-arm64

Auto-detect architecture:

docker run -d -p 8100:8100 neosun/notebooklm2ppt:latest

Access at: http://localhost:8100

Option 3: API Server

# Install with server dependencies
pip install "notebooklm2ppt[server]"

# Start server
python -m uvicorn web.app:app --host 0.0.0.0 --port 8100

API Documentation: http://localhost:8100/docs

📦 Installation

Prerequisites

Install Dependencies

macOS:

brew install pdf2svg inkscape

Ubuntu/Debian:

sudo apt-get install pdf2svg inkscape

Windows:

Install notebookLM2PPT

# Recommended: Install with pipx (isolated environment)
pipx install notebooklm2ppt

# Or install with pip
pip install notebooklm2ppt

📖 Usage

Basic Usage

# Specify output file
pdf2ppt input.pdf output.pptx

# Auto-generate output filename (input.pptx)
pdf2ppt input.pdf

# Verbose mode
pdf2ppt input.pdf --verbose

Advanced Usage

# Convert specific pages
pdf2ppt input.pdf -p 1-5,7,9-11

# Parallel processing (4 workers)
pdf2ppt input.pdf -j 4

# Force overwrite existing file
pdf2ppt input.pdf output.pptx --force

# Keep temporary files for debugging
pdf2ppt input.pdf --no-clean

Command Line Options

usage: pdf2ppt [-h] [-v] [--verbose] [--no-clean] [--no-check] [--force]
               [--pages PAGES] [--parallel PARALLEL]
               [--pdf2svg-path PATH] [--inkscape-path PATH]
               input [output]

positional arguments:
  input                 Input PDF file
  output                Output PPTX file (default: input.pptx)

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  --verbose             Verbose output
  --no-clean            Keep temporary files
  --no-check            Skip SVG filter check
  --force, -f           Overwrite output file if exists
  --pages, -p PAGES     Page range (e.g., "1

Tools 1

convert_pdf_to_pptConverts a specified PDF file into a PowerPoint presentation

Try it

Convert the PDF file at /path/to/slides.pdf into a PowerPoint presentation.
Convert pages 1-5 of my presentation.pdf to a new PPTX file.
Process the document slides.pdf using parallel conversion to speed up the output.

Frequently Asked Questions

What are the key features of notebookLM2PPT?

Maintains highest resolution with vector graphics preservation. Automatically detects slide size and aspect ratio. Supports parallel processing for faster conversion. Preserves document metadata like title and author. Allows conversion of specific page ranges.

What can I use notebookLM2PPT for?

Converting LaTeX beamer slides from PDF to editable PowerPoint format. Transforming Typst touying slides into professional PPT presentations. Automating the conversion of large PDF slide decks into presentation-ready files.

How do I install notebookLM2PPT?

Install notebookLM2PPT by running: pip install notebooklm2ppt

What MCP clients work with notebookLM2PPT?

notebookLM2PPT works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep notebookLM2PPT docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare