KitchenSink4AI
INSTALL
PAINT DEPARTMENT · AISLE P CATALOG № 193
SHAPES,
NOT SCREENSHOTS
tap for a fresh coat
Model Context Protocol · Server for Microsoft PowerPoint

Community edition

Kitchen­Sink4PPT

Windows and Linux (macOS is untested in this release)

Everything plus the kitchen sink for Microsoft PowerPoint: the .pptx MCP server that builds diagrams your hands can still move.

9Tools
3,689Tests
193Actions

The Sinks protect file integrity, not the truth of an AI assistant's output. Review AI-generated work before relying on it. Read the Community House Rules.

Install the Sink Read the Source Business editions
↓ or try it first: there is a diagram below you can drag, and the arrows follow
JUST IN New on the shelf

The changes you will notice in KitchenSink4PPT 2.0. Upgrading from 1.x? Every old tool name maps to a new one.

  • Changed: 193 actions, all ready from the first call. Everything PowerPoint 1.x could do is still here, now organised into nine clear tools, so your agent picks the right one faster. A map from each old tool name to its new home ships with the server.
  • Changed: Nothing to switch on. The old tool packs and the calls that enabled them are gone, and the whole surface costs about 7.3k tokens at startup.
  • New: Ask for any action's arguments. One help call returns the arguments and a worked example, and an argument the action does not know is refused by name.
  • New: Bullets and paragraph spacing. Bullets in text boxes get a default hanging indent, and space before and after a paragraph can be set.
  • Fixed: The server closes only the PowerPoint it started. A PowerPoint you opened yourself is never ended, and a hung call is cancelled safely. Encrypted decks are refused before Office is touched.
  • Fixed: Tables, charts and SmartArt keep what they had. Cell formatting survives text edits, chart data and workbooks are preserved, and SmartArt text reads, searches and copies correctly.
DEPT. 00

Move the node, the arrows follow

A diagram that arrives as a picture is flat pixels behind glass. The night before you present, one box needs to move half an inch, and a picture does not care how small the change is. This server draws the diagram out of real PowerPoint shapes, the same ones you would draw by hand, with the arrows genuinely attached to the boxes they join. Drag a node in PowerPoint and the arrows follow. Ask the agent to recolor one box by name and only that box changes. No starting over, no waiting on an image service, and nothing extra to install to build it.

MIXED ON PREMISES
FLAT PNG IT'S A PICTURE

One bitmap. Try to drag it: nothing. To move one node, you go back to the generator, describe the change, wait, and hope the other two nodes come back where they were.

NATIVE SHAPES

This one

go ahead, drag the green node. the arrows follow.

Real PowerPoint shapes, with the arrows actually attached. Nudge the node yourself in ten seconds, or tell the agent to edit exactly one shape by its identity. Everything else stays untouched. Keyboard works too: focus the node and use the arrow keys.

The demo above runs in your browser for the sake of the point; the shipped output is ordinary PowerPoint geometry, so it behaves in PowerPoint exactly the way shapes you drew by hand behave.

DEPT. 01

Why this aisle exists

Ask an AI to put an org chart on slide 12. Suppose it arrives as a picture of an org chart. Then the reorg happens: one name changes, one box moves under a different manager. The box cannot move. It is not a box; it is pixels. Your choices are to regenerate the whole image and hope nothing else shifted, to pay an image service again for the same chart, or to rebuild it by hand, forty minutes of dragging rectangles you did not make.

KitchenSink4PPT draws the chart as real PowerPoint shapes: boxes you can drag, connectors that stay attached when you do, text you can click into. The one-name fix takes ten seconds, by you or by the agent, and the arrows follow.

DEPT. 02

The shelves, tool by tool

The stock is arranged in nine tools, the way a good shop groups what belongs together. Every department below is on the floor from your first call, fully stocked, with nothing to switch on. Upgrading from 1.x? Each old tool name is now an action on one of these shelves, and the server carries the map.

PRIMER WHITESAMPLE POT

Read LOOK BEFORE YOU TOUCH

Read the whole deck as text with a stable address on every slide, find text, list shapes, tables, charts, notes, comments, equations and hyperlinks, and ask the server who it is. Nothing here changes a file, and big decks arrive in pages.

e.g. read the deck as text your agent can point into · find every slide that mentions Q3 · pull the data behind a chart

ppt_read · 28 ACTIONS
LINSEEDSAMPLE POT

Inspect THE WALK-THROUGH

Audits that change nothing: accessibility, layout and overflow checks, font inventory, deck-to-deck comparison, statistics, brand extraction, theme and document properties, diagnostics, and a look at the PowerPoint on this machine.

e.g. find text that overflows its box · compare two versions of a deck · list every font in use

ppt_inspect · 17 ACTIONS
WET EDGESAMPLE POT

Edit THE TOUCH-UPS

Batch edits with one save per batch, search and replace, placeholder text that keeps its formatting, text fitting, bullets, hyperlinks, speaker notes, and the slide actions done right: insert, deep duplicate, delete with cleanup, reorder, hide.

e.g. apply twenty edits in one all-or-nothing batch · duplicate the heaviest slide cleanly · write the speaker notes

ppt_edit · 32 ACTIONS
GILT EDGESAMPLE POT

Graphics THE STATEMENT PIECE

SVG compiled to grouped native shapes, preset and freeform geometry with gradients and theme-color fills, connectors glued to the shapes they join, one-call diagrams, edit one shape by name without touching the rest, group and ungroup, align, distribute, z-order, images, video, audio and equations.

e.g. turn an SVG diagram into shapes you can drag · restyle one connector by id · align a row of boxes mechanically, not by eye

ppt_graphics · 41 ACTIONS
DROP CLOTHSAMPLE POT

Tables plus Charts STAGING THE ROOM

File-based structural table actions: merge cells, insert and delete rows AND columns, borders and shading, verified named table styles, CSV and JSON import. Charts with editable data come along.

e.g. merge a header row · add a column without rebuilding the table · load a table straight from CSV

ppt_tables · 16 ACTIONS
VERDIGRISSAMPLE POT

Design WALLPAPER AND PAINT

Layouts and masters, theme colors and fonts, brand application, slide size, backgrounds, master and layout editing, deck-wide font and color replacement, slide transitions and entrance builds. Themes are the wallpaper and the paint; layouts are where the furniture goes.

e.g. apply the right layout by name · fill a shape with accent 2, not a hex guess · swap a font everywhere at once

ppt_design · 25 ACTIONS
SECOND COATSAMPLE POT

Review THE SECOND OPINION

Modern threaded comments with REPLIES: add, reply, resolve and delete, plus anonymize-for-review.

e.g. reply to the reviewer in the thread · resolve every comment you have handled · strip authorship before blind review

ppt_review · 7 ACTIONS
FRESH COATSAMPLE POT

Deck OUT THE DOOR

Create presentations FROM your own template, copy and snapshot, back up and restore, copy slides between decks, merge and split, export PDF, slide images and handouts, check that the deck opens with no repair prompt, compress, and save or scroll a deck that is open in PowerPoint.

e.g. start a deck from the house template · export slide 7 as a PNG to check the layout · confirm the deck opens with no repair prompt

ppt_deck · 27 ACTIONS
DEPT. 03

The context bill

Every MCP server takes up part of an AI's working memory before any work starts, the way every fixture on the floor takes up floor space whether anyone is browsing it or not. This one has measured its own bill: 9 tools, 193 actions, about 7.3k tokens for all of it, counted from the real tool list. Your assistant stays fast and cheap, and nothing has to be switched on mid-session.

9Tools
7.3kTokens, the whole surface up front
193Actions from the first call
# an agent passes an argument the action does not have > ppt_tables(op="merge_cells", args={"file_path": "deck.pptx", "colour": "red", ...}) REFUSED: BAD_ARGS. The arguments did not fit this operation; ppt_help with this op gives its arguments and an example. > ppt_help(op="merge_cells") OK: arguments and a worked example.

Administrators can narrow the surface: KS4P_READ_ONLY=1 keeps only the tools that read and inspect, and KS4P_FORBID removes named tools or actions.

DEPT. 04

Wiring it in

For developers: pip, source, other MCP clients TRADE COUNTER

Install the package and point any MCP client at the executable:

$ pip install kitchensink4ppt
{ "mcpServers": { "ppt": { "command": "kitchensink4ppt" } } }

Running from a clone works the same way; point the command at the ppt-mcp executable in the clone's virtual environment. Full setup is in the README.

Works with Claude Desktop, Claude Code, Codex, and other AI apps that support local MCP servers, including open-source clients.

ChatGPT on the web uses a separate remote connection. These local installers do not configure it.

Windows and Linux for file editing (macOS is untested in this release). Features that control Microsoft PowerPoint require Windows and PowerPoint.

Choose your computer and the app you use. Open its instructions below.

Choose your AI app

Claude Desktop
  1. Set up the launcher once

    These tools use uv, a small launcher. If you already installed it for another KitchenSink product, skip to the next step.

    Open the Windows Start menu, type PowerShell, and open Windows PowerShell. Copy this command, paste it into that window, and press Enter.

    winget install --id=astral-sh.uv -e

    When it finishes, close and reopen your command window before continuing.

    Launcher help
  2. Download your extension

    This .mcpb file is for Claude Desktop. Your browser usually saves it in Downloads.

  3. Add it to Claude Desktop

    In Claude Desktop, open Settings → Extensions → Advanced settings → Install Extension. Select the .mcpb file you downloaded, then fully quit and reopen Claude Desktop.

  4. Check that it worked

    Open Settings → Extensions and check that your KitchenSink extension is enabled. Start a new chat and ask the app to use its KitchenSink tools to show the server information. A successful tool result confirms it is connected.

Claude Desktop setup guide

ChatGPT Desktop
  1. Set up the launcher once

    These tools use uv, a small launcher. If you already installed it for another KitchenSink product, skip to the next step.

    Open the Windows Start menu, type PowerShell, and open Windows PowerShell. Copy this command, paste it into that window, and press Enter.

    winget install --id=astral-sh.uv -e

    When it finishes, close and reopen your command window before continuing.

    Launcher help
  2. Connect the tool in ChatGPT Desktop

    Open Settings → MCP servers → Add server. Choose STDIO (a tool running on your computer). Enter the fields below; these are settings, not a message to paste into chat. Field names may differ by app version.

    KitchenSink4PPT
    Name
    KitchenSink4PPT
    Command
    uvx
    Arguments
    kitchensink4ppt
  3. Check that it worked

    Save the server, then select Restart. In a new conversation, type /mcp and check that your KitchenSink server is connected.

ChatGPT Desktop setup guide

Claude Code / Codex
  1. Set up the launcher once

    These tools use uv, a small launcher. If you already installed it for another KitchenSink product, skip to the next step.

    Open the Windows Start menu, type PowerShell, and open Windows PowerShell. Copy this command, paste it into that window, and press Enter.

    winget install --id=astral-sh.uv -e

    When it finishes, close and reopen your command window before continuing.

    Launcher help
  2. Add the tools to your app

    With Claude Code or Codex installed, open PowerShell on Windows or Terminal on Mac or Linux. Paste the command for your app and press Enter. Do not paste it into an AI chat.

    Claude Code
    claude mcp add ppt -s user -- uvx kitchensink4ppt
    Codex
    codex mcp add ppt -- uvx kitchensink4ppt
  3. Check that it worked

    Restart your AI session. In Claude Code, open /mcp and check the connection status. In Codex, open /mcp and check the connected servers. If a server fails, use the help below.

Install Claude Code · Install Codex

DEPT. 05

Customer service

NOW SERVING · TAKE A NUMBER · SAME DESK AS THE WORD SINK, ONE AISLE OVER

Bug reports and feature requests are public GitHub issues and require a free account. Licensing inquiries use the private contact form.

Engineered Not to Corrupt

The deck is due at zero eight, PowerPoint is opening it, and there is a repair prompt where your title slide should be. Preventing that morning is this server's first job. A timestamped backup happens before every change, automatically. Every save is verified before it replaces your file. Whatever an edit doesn't touch, animations, media, embedded objects, passes through untouched, byte for byte. And when the server isn't sure which shape you meant, it stops and shows you the candidates instead of guessing.

Provided as-is, without warranty of any kind, per the license; the engineering above is simply how seriously your decks are taken. Keep backups. (It makes them for you.)

DEPT. 06

The other aisles