What can you do with it?

Microsoft PowerPoint allows you to manage presentations programmatically through the Microsoft Graph API. You can list PowerPoint files in your OneDrive, download presentations for viewing or editing, upload new or updated presentations, create temporary shareable links, and retrieve slide thumbnails. This integration is perfect for presentation management, automated sharing, and content organization workflows. Note that direct slide manipulation requires downloading, editing locally, and re-uploading.

How to use it?

Basic Command Structure

/your-Microsoft-PowerPoint-connection [action] [required-parameters] [optional-parameters]

Parameters

Required:

  • action - The operation to perform with PowerPoint

Tools

List Presentations

List all PowerPoint presentations in your OneDrive

Parameters:

  • folder-path (optional) - Specific folder to list from

Example:

/your-Microsoft-PowerPoint-connection
action: list-presentations

Response:

{
  "value": [
    {
      "id": "0123456789abc!123",
      "name": "Presentation1.pptx",
      "size": 204800,
      "createdDateTime": "2024-03-15T10:30:00Z",
      "lastModifiedDateTime": "2024-03-15T14:45:00Z"
    },
    {
      "id": "0123456789abc!124",
      "name": "Quarterly.pptx",
      "size": 307200
    }
  ]
}

Get Presentation by Path

Retrieve a specific presentation by its file path

Parameters:

  • file-path (required) - Path to the PowerPoint file

Example:

/your-Microsoft-PowerPoint-connection
action: get-by-path
file-path: /Presentations/Quarterly.pptx

Response:

{
  "id": "0123456789abc!123",
  "name": "Quarterly.pptx",
  "size": 204800,
  "webUrl": "https://onedrive.live.com/...",
  "file": {
    "mimeType": "application/vnd.openxmlformats-officedocument.presentationml.presentation"
  }
}

Search Presentations

Search for PowerPoint presentations by name

Parameters:

  • search-query (required) - Search term (e.g., presentation name or .pptx)

Example:

/your-Microsoft-PowerPoint-connection
action: search-presentations
search-query: quarterly report

Response:

{
  "value": [
    {
      "id": "0123456789abc!123",
      "name": "Quarterly Report Q1.pptx",
      "size": 204800,
      "parentReference": {
        "path": "/drive/root:/Presentations"
      }
    }
  ]
}

Download Presentation

Download a PowerPoint presentation

Parameters:

  • item-id (required) - The ID of the presentation to download

Example:

/your-Microsoft-PowerPoint-connection
action: download-presentation
item-id: 0123456789abc!123

Response:

{
  "status": "downloaded",
  "filename": "Presentation1.pptx",
  "size": 204800,
  "contentType": "application/vnd.openxmlformats-officedocument.presentationml.presentation"
}

Upload Presentation

Upload a new or updated PowerPoint presentation

Parameters:

  • file-path (required) - Destination path for the file
  • content (required) - Binary content of the presentation

Example:

/your-Microsoft-PowerPoint-connection
action: upload-presentation
file-path: /Presentations/NewPresentation.pptx
content: [binary content]

Response:

{
  "id": "0123456789abc!125",
  "name": "NewPresentation.pptx",
  "size": 204800,
  "webUrl": "https://onedrive.live.com/...",
  "createdDateTime": "2024-03-15T16:00:00Z"
}

Generate a temporary public link for a presentation

Parameters:

  • item-id (required) - The ID of the presentation
  • link-type (optional) - Type of link: view or edit (default: view)
  • expiration-hours (optional) - Hours until expiration (default: 24)

Example:

/your-Microsoft-PowerPoint-connection
action: create-share-link
item-id: 0123456789abc!123
link-type: view
expiration-hours: 48

Response:

{
  "id": "share123",
  "roles": ["read"],
  "shareId": "u!aHR0cHM6Ly8...",
  "expirationDateTime": "2025-03-17T12:00:00Z",
  "link": {
    "scope": "anonymous",
    "type": "view",
    "webUrl": "https://1drv.ms/p/s!..."
  }
}

Get Slide Thumbnails

Retrieve thumbnail images for presentation slides

Parameters:

  • item-id (required) - The ID of the presentation

Example:

/your-Microsoft-PowerPoint-connection
action: get-thumbnails
item-id: 0123456789abc!123

Response:

{
  "value": [
    {
      "id": "0",
      "large": {
        "height": 800,
        "width": 1280,
        "url": "https://example.com/thumbnail_large.png"
      },
      "medium": {
        "height": 427,
        "width": 640,
        "url": "https://example.com/thumbnail_medium.png"
      },
      "small": {
        "height": 213,
        "width": 320,
        "url": "https://example.com/thumbnail_small.png"
      }
    }
  ]
}

Notes

PowerPoint files use the MIME type application/vnd.openxmlformats-officedocument.presentationml.presentation. There is no direct API for manipulating individual slides or shapes - presentations must be downloaded, edited locally, and re-uploaded. Files open in desktop PowerPoint may be locked for editing via the API. Proper permissions (Files.ReadWrite or Files.Read) are required in Azure AD. The Paragon proxy is not supported for PowerPoint operations.