Skip to main content
Glama
Caryyon

mcp-monodraw

by Caryyon
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

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: DiagramMCP

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Caryyon/mcp-monodraw'

If you have feedback or need assistance with the MCP directory API, please join our Discord server