Skip to main content
MCP server CX Codex

PlantUML Diagrams — Claude Code MCP server: install and use

PlantUML Diagrams — an MCP server that turns PlantUML code into embeddable SVG or PNG images and local files. It validates markup and automatically repairs broken diagram syntax.

MIT 1,819 installs ★ 55 updated 2026-10-27

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http plantuml-mcp-server https://plantuml-mcp-server--infobip.run.tools
Open on GitHub

What PlantUML Diagrams does

This server gives your coding assistant access to PlantUML generation via tools such as generate_plantuml_diagram, encode_plantuml, and decode_plantuml. The agent can build sequence flows, class structures, or C4 containers directly in conversation, returning ready-to-use image URLs.

It also bundles a prompt called plantuml_error_handling. If a diagram fails validation, this workflow instructs the model to inspect the compiler response and repair syntax flaws like misformed arrows or unclosed quotation marks.

Writing images to disk is locked down by default. The tool restricts output_path exclusively to .svg or .png files inside your current working directory. You must supply PLANTUML_ALLOWED_DIRS if you want to export diagrams to other folders.

What it helps with

  • Render software architecture flows into SVG or PNG URLs
  • Export generated diagrams directly to local image files
  • Encode diagram source strings for sharing via web links
  • Automatically correct broken PlantUML syntax without manual edits

Example prompts for the agent

  • Generate a sequence diagram for our OAuth2 login flow and share the PNG link
  • Export a C4 container diagram of this repository to docs/system.svg
  • Encode this PlantUML snippet into a shareable string

How to install PlantUML Diagrams

Platform CLI: remote server

claude mcp add --transport http plantuml-mcp-server https://plantuml-mcp-server--infobip.run.tools

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about PlantUML Diagrams

How do I install PlantUML Diagrams in Claude Code?

Run claude mcp add --transport http plantuml-diagrams https://plantuml-mcp-server--infobip.run.tools in your terminal.

What does the plantuml_error_handling prompt do?

It teaches the agent how to parse validation responses from the renderer. When syntax issues arise, the model detects typos or missing syntax elements and re-runs the request with fixes.

Where can the server write diagram files locally?

By default, exports are limited to .svg and .png files within the active working directory. To write elsewhere, define target paths in the PLANTUML_ALLOWED_DIRS environment variable.

Similar MCP servers

All MCP servers for Writing and docs →

More in the catalog

Project sponsors

Companies that keep this analytics open