Skip to main content
MCP server CX Codex

Markasso — Claude Code MCP server: diagrams and setup

This MCP server for Claude Code creates and edits Markasso diagrams. An agent can also join a shared board and work on it live.

MIT ★ 7 updated 2026-11-16

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env MARKASSO_LICENSE=<MARKASSO_LICENSE> --env MARKASSO_URL=<MARKASSO_URL> --transport stdio mcp -- npx -y @markasso/mcp
Open on GitHub

What Markasso does

Markasso gives an agent tools to create, inspect, and change diagrams. It can add nodes and connections, edit labels and layout, search for architecture icons, and save work as .markasso or export it as SVG or PNG. The server reports overlaps and crossings that affect diagram readability.

For shared work, the agent joins an active Markasso session. Participants see its edits, and it can read changes made on the board. Live sessions require a Markasso Cloud licence and the MARKASSO_LICENSE variable; other operations do not require that licence. Node 22+ is required. Set MARKASSO_URL to connect to another Markasso instance.

What it helps with

  • build an architecture diagram from nodes and connections
  • inspect a diagram and spot layout problems
  • arrange a diagram from left to right or top to bottom
  • export a diagram as SVG or PNG
  • edit a shared Markasso board

Example prompts for the agent

  • Create a service architecture diagram with an API, database, and queue.
  • Read the diagram and arrange it from left to right.
  • Join the active Markasso session and add the missing database node to the board.

How to install Markasso

Platform CLI

claude mcp add --env MARKASSO_LICENSE=<MARKASSO_LICENSE> --env MARKASSO_URL=<MARKASSO_URL> --transport stdio mcp -- npx -y @markasso/mcp

Replace <…> with your own values

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 Markasso

How do I install Markasso in Claude Code?

Run claude mcp add markasso -e MARKASSO_LICENSE=<MARKASSO_LICENSE> -- npx -y @markasso/mcp. Live sessions require a Markasso Cloud licence key.

What does Markasso do?

It lets an agent create and edit diagrams, inspect their structure, and export them. Agents can also join a shared Markasso board.

What does Markasso need to run?

Node 22+ is required. Drawing on a shared board needs a Markasso Cloud licence and the MARKASSO_LICENSE variable; MARKASSO_URL selects another Markasso instance.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open