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
claude mcp add --env MARKASSO_LICENSE=<MARKASSO_LICENSE> --env MARKASSO_URL=<MARKASSO_URL> --transport stdio mcp -- npx -y @markasso/mcpWhat 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/mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp --env MARKASSO_LICENSE=<MARKASSO_LICENSE> --env MARKASSO_URL=<MARKASSO_URL> -- npx -y @markasso/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@markasso/mcp"
],
"env": {
"MARKASSO_LICENSE": "<MARKASSO_LICENSE>",
"MARKASSO_URL": "<MARKASSO_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@markasso/mcp"
],
"env": {
"MARKASSO_LICENSE": "<MARKASSO_LICENSE>",
"MARKASSO_URL": "<MARKASSO_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MARKASSO_LICENSE=<MARKASSO_LICENSE> -e MARKASSO_URL=<MARKASSO_URL> mcp npx -y @markasso/mcpReplace <…> 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.