Skip to content

juanhcode/powerpoint-design

v1.0.0MIT

Create, edit, template, and export PowerPoint presentations directly from Kiro using natural language and the PowerPoint MCP server.

πŸ“Š PowerPoint Design Power for Kiro

Create, edit, template, and export PowerPoint presentations directly from Kiro using the PowerPoint MCP server.

The PowerPoint Design Power for Kiro brings slide-deck creation capabilities directly into your AI-powered development workflow.

Instead of manually building slides in PowerPoint, you can use natural language to create, edit, template, and export presentations through the PowerPoint MCP server.


✨ Features

  • πŸ“Š Create PowerPoint presentations using natural language
  • 🧱 Build slides from a topic or an outline
  • 🎨 Apply professional themes and color schemes
  • πŸ—‚οΈ Create presentations from templates
  • ✏️ Edit existing presentations
  • πŸ“ˆ Add charts, tables, shapes, and images
  • πŸ”€ Manage text, bullet points, and fonts
  • 🏷️ Apply brand guidelines
  • πŸ“€ Export and save decks as .pptx and other formats
  • πŸ€– AI-assisted presentation workflows inside Kiro

🧠 How It Works

The PowerPoint Design Power provides presentation-specific instructions, workflows, and skills that help Kiro work with PowerPoint.

The Power does not implement the PowerPoint MCP server itself.

Instead, the PowerPoint MCP server provides the actual connection between Kiro and the .pptx files.

flowchart TD
    User["πŸ‘€ User<br/><i>'Create a 5-slide deck'</i>"]
    subgraph Kiro["πŸ€– Kiro"]
        Power["PowerPoint Design Power<br/>Skills Β· Steering Β· Workflows"]
    end
    MCP["πŸ”Œ PowerPoint MCP Server"]
    Files["πŸ“Š .pptx files<br/>Slides Β· Charts Β· Media"]

    User --> Kiro
    Power -->|MCP| MCP
    MCP --> Files

Two separate components

The setup consists of two independent components:

flowchart TD
    subgraph A["πŸ“¦ PowerPoint Design Power"]
        A1["Instructions"]
        A2["Skills"]
        A3["Workflows"]
        A4["Design guidelines"]
    end
    subgraph B["πŸ”Œ PowerPoint MCP Server"]
        B1["Slide operations"]
        B2["Charts / tables"]
        B3["File save / export"]
    end
    A --> B

The Power is distributed through this repository.

The PowerPoint MCP server runs locally in the user's Kiro environment.

Request flow

A typical presentation request flows like this:

sequenceDiagram
    actor U as User
    participant K as Kiro (Power)
    participant M as PowerPoint MCP
    participant F as .pptx file

    U->>K: "Create Module 1 from Template.pptx"
    K->>M: Inspect template layouts
    M-->>K: Layouts & placeholders
    K->>M: Create presentation from template
    K->>M: Add slides + populate content
    M-->>K: Operation confirmed
    K->>M: Save presentation
    M->>F: Write .pptx
    M-->>K: File path
    K-->>U: Deck ready βœ…

πŸš€ Getting Started

Prerequisites

Before using the Power, make sure you have:

  • Kiro installed
  • MCP support enabled in Kiro
  • uv / uvx installed (used to run the PowerPoint MCP server)

1. Install the Power

Install the PowerPoint Design Power using Kiro's Power installation flow.

The Power contains:

powerpoint-design/
β”œβ”€β”€ plugin.json
β”œβ”€β”€ POWER.md
β”œβ”€β”€ README.md
β”œβ”€β”€ PRIVACY.md
β”œβ”€β”€ LICENSE
β”œβ”€β”€ dev.kiro/
β”‚   └── steering/
└── skills/

The Power itself does not contain any credentials or authentication information.


2. Install uv / uvx

The PowerPoint MCP server runs through uvx, which ships with uv.

Install uv (macOS / Linux):

curl -LsSf https://astral.sh/uv/install.sh | sh

By default it installs to ~/.local/bin. Make sure that directory is on your PATH.

Verify the installation:

uv --version
# e.g. uv 0.12.10 (aarch64-apple-darwin)

For other platforms or installation methods, see the uv installation guide.


3. Verify the PowerPoint MCP server

Run the server once manually to let uvx download it and confirm it starts:

uvx --from "office-powerpoint-mcp-server" --with "mcp<2" ppt_mcp_server

This project uses the office-powerpoint-mcp-server package. The --with "mcp<2" flag pins a compatible MCP client version.

Once it starts without errors, stop it (Ctrl+C) β€” Kiro will launch it automatically from the config below.


4. Configure PowerPoint MCP

Add the server to your Kiro MCP config. Use ~/.kiro/settings/mcp.json for a global connection, or .kiro/settings/mcp.json inside a workspace.

{
  "mcpServers": {
    "powerpoint": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "--with",
        "mcp<2",
        "ppt_mcp_server"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

This configuration is intentionally not committed with credentials. Each user configures the MCP connection in their own Kiro environment. After saving, reconnect the server from Kiro's MCP Server view if it doesn't pick up automatically.


5. Start Creating

Once the PowerPoint Design Power and PowerPoint MCP are configured, you can interact with PowerPoint directly from Kiro using natural language.

For example:

Create a 6-slide presentation introducing Kiro for a technical audience.
Use a modern blue color scheme.

Or:

Create a presentation from my template at ./templates/corporate.pptx

Or:

Open report.pptx and change the title on slide 1 to "Q3 Results".

πŸ’‘ Usage

You don't need to know the PowerPoint MCP tools to use the Power.

Simply describe what you want Kiro to create or change.

πŸ“Š Create a Presentation

Create a 5-slide deck about cloud computing for beginners.
Create a presentation introducing our AWS student community.
Auto-generate a business presentation about Kubernetes with charts.

πŸ—‚οΈ Use Templates

Create a presentation from the template at ./templates/brand.pptx
Use the title_slide and text_with_image templates to build a 4-slide deck.

✏️ Edit Presentations

Open deck.pptx and change the date on the title slide to September 20.
Add a bar chart of quarterly revenue to slide 3.
Make slide 2 more minimal and keep the current theme.

The Power encourages preserving the existing visual identity unless the user explicitly requests a redesign.


🏷️ Apply Brand Guidelines

Organizations can customize the Power with their own branding rules in:

dev.kiro/steering/brand-guidelines.md

For example:

Create a promotional deck for our next meetup.

Follow the brand guidelines defined in the PowerPoint Design Power.

πŸ“€ Export Presentations

Save the presentation as deck.pptx.
Export the final presentation.

Available formats depend on the PowerPoint MCP server's capabilities.


πŸ“ Project Structure

powerpoint-design/
β”‚
β”œβ”€β”€ plugin.json
β”œβ”€β”€ POWER.md
β”œβ”€β”€ README.md
β”œβ”€β”€ PRIVACY.md
β”œβ”€β”€ LICENSE
β”‚
β”œβ”€β”€ dev.kiro/
β”‚   └── steering/
β”‚       β”œβ”€β”€ powerpoint-design.md
β”‚       └── brand-guidelines.md
β”‚
└── skills/
    β”œβ”€β”€ create-slides/
    β”‚   └── SKILL.md
    β”œβ”€β”€ auto-generate-deck/
    β”‚   └── SKILL.md
    β”œβ”€β”€ edit-presentation/
    β”‚   └── SKILL.md
    β”œβ”€β”€ apply-template/
    β”‚   └── SKILL.md
    β”œβ”€β”€ manage-media/
    β”‚   └── SKILL.md
    β”œβ”€β”€ manage-charts/
    β”‚   └── SKILL.md
    β”œβ”€β”€ manage-tables/
    β”‚   └── SKILL.md
    β”œβ”€β”€ style-and-theme/
    β”‚   └── SKILL.md
    β”œβ”€β”€ presenter-notes/
    β”‚   └── SKILL.md
    β”œβ”€β”€ export-presentation/
    β”‚   └── SKILL.md
    └── workflow/
        └── SKILL.md

skills/

Specialized presentation workflows. Each skill lives in its own directory with a SKILL.md file.

SkillDescription
create-slidesCreate new presentations and slides
auto-generate-deckGenerate a full presentation from a single topic
edit-presentationModify existing presentations
apply-templateBuild decks from templates and layouts
manage-mediaWork with images, shapes, and visual elements
manage-chartsAdd and update charts (bar, line, pie)
manage-tablesAdd and format tables
style-and-themeApply professional themes and color schemes
presenter-notesAdd and manage speaker notes
export-presentationSave and export presentations
workflowEnd-to-end presentation workflow guidelines

Skills map

The skills grouped by category:

flowchart TD
    Power["πŸ“Š PowerPoint Design Power"]

    Power --> Create["🧱 Create"]
    Power --> Edit["✏️ Edit"]
    Power --> Media["πŸ“ˆ Media"]
    Power --> Style["🎨 Style"]
    Power --> Output["πŸ“€ Output"]
    Power --> Meta["🧭 Meta"]

    Create --> C1["create-slides"]
    Create --> C2["auto-generate-deck"]
    Create --> C3["apply-template"]

    Edit --> E1["edit-presentation"]

    Media --> M1["manage-media"]
    Media --> M2["manage-charts"]
    Media --> M3["manage-tables"]

    Style --> S1["style-and-theme"]
    Style --> S2["presenter-notes"]

    Output --> O1["export-presentation"]

    Meta --> W1["workflow"]

πŸ” Security

This project does not store or manage credentials.

Never commit:

.env
credentials
access tokens
API keys
passwords

πŸ”’ Privacy Policy

This project does not collect, store, or manage credentials, OAuth tokens, or API keys.

For full details, see the Privacy Policy.


πŸ†˜ Support

If you have questions, find a bug, or want to request a feature:


πŸ“„ License

This project is licensed under the MIT License.


πŸ™ Acknowledgements

This project builds upon:

  • Kiro β€” AI-powered development environment
  • PowerPoint β€” Microsoft presentation format (.pptx)
  • Model Context Protocol (MCP) β€” Open protocol for connecting AI applications with external tools

This project is an independent open-source project and is not affiliated with or endorsed by Microsoft.