Skip to main content
Glama

mcp-monodraw

An MCP (Model Context Protocol) server for Monodraw, the powerful ASCII art editor for macOS.

Features

  • Export diagrams - Convert .monopic and .monojson files to plain text or JSON

  • List 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-monodraw

Or use directly with npx:

npx mcp-monodraw

Configuration

Claude Code

Add the MCP server to your project or global config:

claude mcp add monodraw -- npx mcp-monodraw

Or 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 file

list_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 open

get_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 width

Prompts

Pre-built templates for generating diagrams:

  • flowchart - Create flowchart diagrams

  • box-diagram - Create box/container diagrams

  • sequence-diagram - Create sequence diagrams

  • architecture - Create architecture diagrams

  • table - Create ASCII tables

  • tree - 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 dev

License

MIT

Available Tools

6 tools
create_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

    A3.7/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
      -
    • F
      license
      A
      quality
      C
      maintenance
      Exposes 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.
      8
      2
      -