Skip to content

albertobarrago/markasso

v1.1.0MIT

The whiteboard your agents draw on: architecture diagrams, flowcharts and sketches, offline or live on a shared board with people.

Markasso for Claude Code and Codex

The whiteboard your agents draw on. This plugin gives Claude the Markasso tools: it draws architecture diagrams, flowcharts and sketches, lays them out by itself, looks at the result, and hands you a markasso.it link, a .markasso file or an SVG. With a live link it joins a shared board and draws next to the people on it, in real time.

Install

claude plugin marketplace add AlbertoBarrago/markasso-plugin
claude plugin install markasso@markasso

Or from inside a session: /plugin install markasso --marketplace AlbertoBarrago/markasso-plugin.

Codex CLI:

codex plugin marketplace add AlbertoBarrago/markasso-plugin
codex plugin add markasso@markasso

Codex reads the portable manifest (plugin.json, mcp.json); Claude Code reads .claude-plugin/. Both get the same server and skill.

The plugin runs the @markasso/mcp server with npx, so it needs Node 22 or later. Without the plugin, the same server works in any MCP client: see its README.

Try it

  • "Draw the architecture of this repository: services, data stores and how they talk. Give me a share link."
  • "Turn the checkout flow in src/checkout into a flowchart with the decision points."
  • "Join https://markasso.it/?live=… and add the missing cache to the diagram on the board."

What it includes

  • MCP server markasso: create, read and edit diagrams, export PNG and SVG, share links, live sessions.
  • Skill diagram: tells Claude when to reach for Markasso and how to draw a clear diagram with it.

Live sessions and licence

Everything is free except drawing live in a shared session, which needs a Markasso Cloud licence. When you enable the plugin, Claude Code asks for the key: leave it empty if you do not have one. It is stored in your system's secure credential store and sent only to markasso.it.

Codex plugins have no prompt for a key, so the plugin in Codex does everything except live sessions. To draw live from Codex, add the server on its own with the key in its environment instead of the plugin: codex mcp add markasso --env MARKASSO_LICENSE=<your key> -- npx -y @markasso/mcp@latest.

Privacy

Diagrams stay on your machine until you share them. diagram_share uploads the diagram to markasso.it to create its link; live sessions send your edits to the room you joined.

Licence

MIT