cotera
Logo

Microsoft PowerPoint 365

Authentication: Microsoft OAuth. Requires a connected Microsoft 365 account with access to the relevant Microsoft resources, such as Word, Excel, PowerPoint, OneDrive, SharePoint, Outlook, Calendar, or Teams depending on the tool.

Description: Read, create, and build themed Microsoft PowerPoint presentations.

Beta Notice

This tool is currently in beta testing and not yet available for general use.

To get the Microsoft PowerPoint 365 tool added to your Cotera workspace, please contact our support team at support.cotera.co.

Presentations

Extract content from and create PowerPoint presentations.

Read Presentation

Read a presentation to extract the text content from a PowerPoint file's slides.

Operation Type: Query (Read)

Parameters:

  • itemId string (required): The drive item ID of the PowerPoint (.pptx) file.
  • driveId string (nullable, default null): The drive ID containing the file (from SharePoint search results). Omit or null to read from the signed-in user's OneDrive.

Returns:

  • id string: The drive item ID.
  • name string: The file name.
  • size int (nullable): The file size in bytes.
  • webUrl string (nullable): The web URL of the file.
  • text string (nullable): Extracted plain text of all slides, in slide order. Null when the file was too large to read.
  • slideCount int (nullable): The number of slides in the presentation.
  • truncated boolean: Whether the text was cut off, or omitted entirely because the file exceeded the size limit.

Limits: Files exceeding 25 MB return text=null, slideCount=null, and truncated=true. Text exceeding 500,000 characters is sliced and truncated=true.

Create Presentation

Create a new PowerPoint presentation file from a list of slides and upload it to OneDrive or SharePoint.

Operation Type: Mutation (Write)

Parameters:

  • siteId string (nullable, default null): The SharePoint site ID. Omit or null to use the signed-in user's OneDrive.
  • driveId string (nullable, default null): A specific document library drive ID to save into. Omit or null to use the signed-in user's OneDrive.
  • parentItemId string (nullable, default null): The parent folder item ID to save into. Omit or null to save to the root of the selected drive.
  • fileName string (required): The name of the presentation file, including the .pptx extension (e.g. "Kickoff.pptx").
  • slides array (required): Array of slide objects. Each slide has:
    • title string (required): Slide title.
    • body string (nullable, default null): Slide body text.
  • conflictBehavior string (nullable, default "replace"): Conflict resolution behavior for the upload.

Returns:

  • id string: The drive item ID of the created presentation.
  • name string: The file name.
  • webUrl string (nullable): The web URL of the created presentation.
  • size int (nullable): The file size in bytes.

Build Presentation

Builds a themed PowerPoint presentation from slide specifications and uploads it as a .pptx file to OneDrive or SharePoint.

Operation Type: Mutation (Write)

Parameters:

  • siteId string (nullable, default null): SharePoint site ID for destination. If omitted, uses OneDrive.
  • driveId string (nullable, default null): A specific document library drive ID to save into. Omit or null to use the signed-in user's OneDrive.
  • parentItemId string (nullable, default null): Parent folder item ID. If omitted, uploads to root.
  • fileName string (required): Name for the new .pptx file, including the .pptx extension (e.g. "Kickoff.pptx").
  • title string (required): The title of the presentation, stored in the file metadata.
  • theme string (nullable, default null): Theme preset name. One of: "modern-dark", "corporate", "vibrant", "minimal", "warm", "bold", "ocean", "sunset", "forest", "tech", "pastel". If omitted, defaults to "corporate".
  • customTheme object (nullable): Custom theme overrides. All fields are nullable; null/empty/whitespace values are treated as "unset" (no override). Only non-empty values that fail hex validation raise field-specific errors.
    • background string (nullable): Background hex color.
    • backgroundAlt string (nullable): Alternate background hex color.
    • text string (nullable): Primary text hex color.
    • textSecondary string (nullable): Secondary text hex color.
    • heading string (nullable): Heading hex color.
    • accent string (nullable): Accent hex color.
    • accentSecondary string (nullable): Secondary accent hex color.
    • headingFont string (nullable): Font family for headings.
    • bodyFont string (nullable): Font family for body text.
    • gradientAngle number (nullable): Gradient angle in degrees.
    • gradientStartColor string (nullable): Gradient start hex color.
    • gradientEndColor string (nullable): Gradient end hex color.
  • slides array (required): Array of slide specification objects. Each slide has:
    • template string (nullable): Template name. One of: "title", "section", "content", "content-image", "bullets", "stats", "quote", "closing", "two-column", "comparison", "timeline", "table". If omitted, template is auto-detected from slide content.
    • heading string (nullable, default null): Slide heading displayed in large bold text.
    • subtitle string (nullable): Slide subtitle.
    • body string (nullable): Slide body text.
    • imageUrl string (nullable): Image URL for content-image slides.
    • bullets array (nullable): Array of { title, description } objects (both fields optional). Empty items are dropped; an empty list collapses to null before rendering.
    • stats array (nullable): Array of { value, label, description } objects (all fields nullable). Empty items are dropped.
    • columns array (nullable): Array of { heading, body } objects for two-column slides. Empty items are dropped.
    • steps array (nullable): Array of { title, description } objects for timeline slides. Empty items are dropped.
    • tableData object (nullable): Table data for table slides, with headers (array of strings) and rows (array of arrays). Empty tables collapse to null.
    • quote string (nullable): Quote text to display. Used with the "quote" template.
    • attribution string (nullable): Attribution for the quote (e.g., person name, source). Displayed below the quote.
    • notes string (nullable): Speaker notes.
  • conflictBehavior string (default "replace"): File conflict behavior: "replace" (default), "fail", or "rename".

Normalization: Blank/whitespace strings are normalized to null. Empty items are dropped from arrays. Empty lists and tables collapse to null before rendering.

Returns:

  • id string: The item ID of the uploaded file.
  • name string: The name of the uploaded file.
  • webUrl string (nullable): Web URL to access the file.
  • size number (nullable): File size in bytes.