mcp-monodraw
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-monodraw create a flowchart for user signup flow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-monodraw
An MCP (Model Context Protocol) server for Monodraw, the powerful ASCII art editor for macOS.
Features
Export diagrams - Convert
.monopicand.monojsonfiles to plain text or JSONList diagrams - Find all Monodraw files in a directory
Open in Monodraw - Launch files directly in the Monodraw app
Create ASCII art - Generate boxes, flowcharts, tables, trees, and sequence diagrams
Diagram prompts - Pre-built templates for common diagram types
Related MCP server: ASCIIFlow MCP Server
Requirements
Node.js 18+
macOS
Monodraw (Direct version from helftone.com, not App Store)
Note: The Monodraw CLI is only available in the Direct version. The Mac App Store version does not include CLI support due to sandbox restrictions.
Installation
npm install -g mcp-monodrawOr use directly with npx:
npx mcp-monodrawConfiguration
Claude Code
Add the MCP server to your project or global config:
claude mcp add monodraw -- npx mcp-monodrawOr manually add to ~/.claude/settings.json:
{
"mcpServers": {
"monodraw": {
"command": "npx",
"args": ["mcp-monodraw"]
}
}
}Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"monodraw": {
"command": "npx",
"args": ["mcp-monodraw"]
}
}
}Tools
export_diagram
Export a Monodraw diagram to plain ASCII text.
filePath: string (required) - Path to the .monopic or .monojson file
unicode: boolean - Use Unicode characters in output (default: false)
trimWhitespace: boolean - Trim trailing whitespace (default: true)export_diagram_json
Export a diagram with full metadata as structured JSON.
filePath: string (required) - Path to the diagram filelist_diagrams
Find all Monodraw files in a directory.
directory: string - Directory to search (default: ".")
recursive: boolean - Search subdirectories (default: true)open_in_monodraw
Open a file in the Monodraw application.
filePath: string (required) - Path to the file to openget_diagram_preview
Get a text preview of a diagram file.
filePath: string (required) - Path to the diagram file
maxLines: number - Maximum lines to return (default: 20)create_ascii_art
Generate ASCII art programmatically.
type: "box" | "flowchart" | "sequence" | "architecture" | "table" | "tree"
content: string (required) - Content or description
style: "single" | "double" | "rounded" | "heavy" | "ascii" (default: "single")
width: number - Maximum widthPrompts
Pre-built templates for generating diagrams:
flowchart- Create flowchart diagramsbox-diagram- Create box/container diagramssequence-diagram- Create sequence diagramsarchitecture- Create architecture diagramstable- Create ASCII tablestree- Create tree structures
Examples
Export a diagram
Use the export_diagram tool with filePath: "/path/to/diagram.monopic"Create a flowchart
Use the create_ascii_art tool with:
type: "flowchart"
content: "Start, Process Data, Validate, Save, End"
style: "rounded"Output:
╭─────────────────╮
│ Start │
╰─────────────────╯
│
v
╭─────────────────╮
│ Process Data │
╰─────────────────╯
│
v
╭─────────────────╮
│ Validate │
╰─────────────────╯
│
v
╭─────────────────╮
│ Save │
╰─────────────────╯
│
v
╭─────────────────╮
│ End │
╰─────────────────╯Development
# Install dependencies
yarn install
# Build
yarn build
# Run in development
yarn devLicense
MIT
Available Tools
6 toolscreate_ascii_artB
Generate ASCII art (boxes, flowcharts, tables, trees, sequence diagrams)
Inputs: type (required), content (required), style, width.
export_diagramA
Export a Monodraw diagram (.monopic or .monojson) to plain ASCII text
Inputs: filePath (required), unicode, trimWhitespace.
export_diagram_jsonA
Export a Monodraw diagram with full metadata as structured JSON
Inputs: filePath (required).
get_diagram_previewA
Get a text preview of a Monodraw diagram file
Inputs: filePath (required), maxLines.
list_diagramsB
Find all Monodraw diagram files (.monopic, .monojson) in a directory
Inputs: directory, recursive.
open_in_monodrawB
Open a file in the Monodraw application
Inputs: filePath (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Tools are largely distinct: create_ascii_art generates, list_diagrams finds, get_diagram_preview and export_diagram provide text output (with slight overlap), export_diagram_json gives structured JSON, and open_in_monodraw launches the app. The difference between preview and export could be ambiguous, but descriptions clarify intent.
Most tools follow a verb_noun pattern (export_diagram, list_diagrams, get_diagram_preview, create_ascii_art). Slight deviations: export_diagram_json has an extra suffix, and open_in_monodraw uses a prepositional phrase, but overall the naming is clear and predictable.
Six tools is well-scoped for a Monodraw server covering creation, listing, preview, export, and opening. Each tool has a clear purpose and none seem redundant or out of place.
The set covers the main workflow: create, discover, preview, export (text/JSON), and open in the app. Missing update/delete operations are acceptable since the tool is focused on generation and export, but a raw file content retrieval tool could be a minor gap.
Maintenance
Related MCP Connectors
Make editable flowcharts, process charts, funnels, timelines and data models from plain language.
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
1Draw diagrams, build HTML pages and write Markdown in a live editor the user sees.
Draws UI wireframes from a small text language: multi-screen boards with notes and flow arrows.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables creation of text-based visual elements including bordered boxes with shading, formatted tables, and diagrams using Unicode box drawing characters and ASCII art palettes for terminal output, documentation, and chat interfaces.3-
- FlicenseAqualityCmaintenanceExposes ASCIIFlow drawing primitives as tools to enable AI assistants to generate ASCII wireframes and diagrams from natural language descriptions. It provides commands for creating canvases and drawing boxes, lines, arrows, and text using a character-grid coordinate system.82-
- AlicenseBqualityCmaintenanceEnables AI assistants to create, animate, and export ASCII art using natural language, with live browser sync.9654 npm12MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI to create ASCII and SVG art through a character canvas, with tools for drawing, previewing, and exporting to multiple formats, as well as composing stop-motion animations with optional voice-over.MIT