generate_powerpoint_presentation
Create PowerPoint presentations with custom slides, charts, and themes using Microsoft 365 data. Generate professional slides, add visual elements, and apply branding templates.
Instructions
Create professional PowerPoint presentations with custom slides, charts, tables, and themes from Microsoft 365 data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: create new presentation, get existing, list all, or export to format | |
| fileName | No | Name for the new presentation file (for create action) | |
| driveId | No | OneDrive/SharePoint drive ID where file should be created (default: user's OneDrive) | |
| folderId | No | Folder ID within the drive (default: root) | |
| template | No | Template configuration for presentation styling | |
| slides | No | Array of slide definitions to create | |
| fileId | No | File ID for get/export actions | |
| format | No | Export format (for export action) | |
| filter | No | OData filter for list action | |
| top | No | Number of results to return (for list action) |
Implementation Reference
- src/handlers/powerpoint-handler.ts:18-45 (handler)Primary handler function that dispatches PowerPoint operations based on action (create, get, list, export). Calls createPresentation for generation.export async function handlePowerPointPresentations( args: PowerPointPresentationArgs, graphClient: Client ): Promise<string> { try { switch (args.action) { case 'create': return await createPresentation(args, graphClient); case 'get': return await getPresentation(args, graphClient); case 'list': return await listPresentations(args, graphClient); case 'export': return await exportPresentation(args, graphClient); default: throw new McpError( ErrorCode.InvalidRequest, `Unknown action: ${args.action}` ); } } catch (error) { if (error instanceof McpError) throw error; throw new McpError( ErrorCode.InternalError, `PowerPoint operation failed: ${error instanceof Error ? error.message : 'Unknown error'}` ); } }
- Zod input schema defining parameters for the generate_powerpoint_presentation tool, including action, slides, template, etc.export const powerPointPresentationArgsSchema = z.object({ action: z.enum(['create', 'get', 'list', 'export']) .describe('Action to perform: create new presentation, get existing, list all, or export to format'), fileName: z.string().optional() .describe('Name for the new presentation file (for create action)'), driveId: z.string().optional() .describe('OneDrive/SharePoint drive ID where file should be created (default: user\'s OneDrive)'), folderId: z.string().optional() .describe('Folder ID within the drive (default: root)'), template: powerPointTemplateSchema.optional() .describe('Template configuration for presentation styling'), slides: z.array(powerPointSlideSchema).optional() .describe('Array of slide definitions to create'), fileId: z.string().optional() .describe('File ID for get/export actions'), format: z.enum(['pptx', 'pdf', 'odp']).optional() .describe('Export format (for export action)'), filter: z.string().optional() .describe('OData filter for list action'), top: z.number().optional() .describe('Number of results to return (for list action)') });
- src/server.ts:1266-1285 (registration)MCP server tool registration binding the tool name to handlePowerPointPresentations handler and powerPointPresentationArgsSchema."generate_powerpoint_presentation", "Create professional PowerPoint presentations with custom slides, charts, tables, and themes from Microsoft 365 data.", powerPointPresentationArgsSchema.shape, {"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false}, wrapToolHandler(async (args: PowerPointPresentationArgs) => { this.validateCredentials(); try { const result = await handlePowerPointPresentations(args, this.getGraphClient()); return { content: [{ type: 'text', text: result }] }; } catch (error) { if (error instanceof McpError) { throw error; } throw new McpError( ErrorCode.InternalError, `Error generating PowerPoint presentation: ${error instanceof Error ? error.message : 'Unknown error'}` ); } }) );
- src/tool-metadata.ts:272-276 (schema)Tool metadata including description, title, and annotations used for tool discovery and UI hints.generate_powerpoint_presentation: { description: "Create professional PowerPoint presentations with custom slides, charts, tables, and themes from Microsoft 365 data.", title: "PowerPoint Generator", annotations: { title: "PowerPoint Generator", readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true } },
- Core creation logic that generates PPTX content via generatePresentationXML and uploads to OneDrive/SharePoint.async function createPresentation( args: PowerPointPresentationArgs, graphClient: Client ): Promise<string> { if (!args.fileName) { throw new McpError(ErrorCode.InvalidRequest, 'fileName is required for create action'); } if (!args.slides || args.slides.length === 0) { throw new McpError(ErrorCode.InvalidRequest, 'At least one slide is required'); } // Determine drive location (default to user's OneDrive) const driveId = args.driveId || 'me'; const folderPath = args.folderId ? `/items/${args.folderId}` : '/root'; // Create empty PowerPoint file const fileName = args.fileName.endsWith('.pptx') ? args.fileName : `${args.fileName}.pptx`; // Create file with content const presentationContent = generatePresentationXML(args.slides, args.template); const uploadedFile = await graphClient .api(`/drives/${driveId}${folderPath}:/${fileName}:/content`) .header('Content-Type', 'application/vnd.openxmlformats-officedocument.presentationml.presentation') .put(presentationContent); return JSON.stringify({ success: true, fileId: uploadedFile.id, fileName: uploadedFile.name, webUrl: uploadedFile.webUrl, driveId: uploadedFile.parentReference?.driveId, message: `PowerPoint presentation "${fileName}" created successfully with ${args.slides.length} slides` }, null, 2); }