add-slide-title-only

Add a title slide to a PowerPoint presentation by specifying the presentation name and slide title.

Instructions

This tool adds a new title slide to the presentation you are working on. The tool doesn't return anything. It requires the presentation_name to work on.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`presentation_name`	Yes	Name of the presentation to add the slide to
`title`	Yes	Title of the slide

Implementation Reference

src/powerpoint/presentation_manager.py:335-349 (handler)

Core handler function that adds a title-only slide to the specified presentation using slide layout 0.

def add_title_slide(self, presentation_name: str, title: str) -> Slide:
    try:
        prs = self.presentations[presentation_name]
    except KeyError as e:
        raise ValueError(f"Presentation '{presentation_name}' not found")

    # Add a slide with title and content
    slide_layout = prs.slide_layouts[self.SLIDE_LAYOUT_TITLE]
    slide = prs.slides.add_slide(slide_layout)

    # Set the title
    title_shape = slide.shapes.title
    title_shape.text = title
    return slide

src/powerpoint/server.py:628-648 (handler)

Server tool call handler for 'add-slide-title-only' that validates input, delegates to PresentationManager.add_title_slide, and returns confirmation.

elif name == "add-slide-title-only":
    presentation_name = arguments.get("presentation_name")
    title = arguments.get("title")

    if not all([presentation_name, title]):
        raise ValueError("Missing required arguments")

    if presentation_name not in presentation_manager.presentations:
        raise ValueError(f"Presentation not found: {presentation_name}")

    try:
        slide = presentation_manager.add_title_slide(presentation_name, title)
    except Exception as e:
         raise ValueError(f"Unable to add '{title} to presentation: {presentation_name}. Error: {e}")

    return [
        types.TextContent(
            type="text",
            text=f"Added slide '{title}' to presentation: {presentation_name}"
        )
    ]

src/powerpoint/server.py:81-99 (registration)

Tool registration in list_tools() including name, description, and input schema definition.

types.Tool(
    name="add-slide-title-only",
    description="This tool adds a new title slide to the presentation you are working on. The tool doesn't "
                "return anything. It requires the presentation_name to work on.",
    inputSchema={
        "type": "object",
        "properties": {
            "presentation_name": {
                "type": "string",
                "description": "Name of the presentation to add the slide to",
            },
            "title": {
                "type": "string",
                "description": "Title of the slide",
            }
        },
        "required": ["presentation_name", "title"],
    },
),

Powerpoint MCP Server