Skip to content
MCP server

MarsDawn

Export Markdown to PDF and open files in the MarsDawn Mac app from an agent

Runs locallyStatus and history
Install
Pricing
Free
Platforms
macOS, CLI
Runs
Locally
Version
0.2.4
Listing updated
2 days ago

About MarsDawn

MarsDawn is a free MCP server for files and documents. It runs locally on your machine and is started by your AI client.

This server is a thin channel over the marsdawn command-line tool, for MCP clients that have no shell of their own. The README itself notes that where a shell exists, calling marsdawn directly is simpler. It needs macOS and the marsdawn CLI installed, and ships as an MCP Bundle (marsdawn.mcpb).

Both tools only work inside folders you allow. Allowed folders come from the extension settings and from MCP roots if the client offers them; with neither, every call is refused, and so is a call the server cannot check. PDFs are rendered with the same exporter as the MarsDawn app, including Mermaid diagrams, and existing PDFs are kept unless force is set. Remote images are off unless allowed.

The open tool needs the MarsDawn app from the Mac App Store and can land on a specific line.

Install

Run in a terminal

claude mcp add marsdawn -- npx -y https://github.com/redtear1115/marsdawn-mcp/releases/download/v0.2.4/marsdawn.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "marsdawn": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/redtear1115/marsdawn-mcp/releases/download/v0.2.4/marsdawn.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "marsdawn": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/redtear1115/marsdawn-mcp/releases/download/v0.2.4/marsdawn.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "marsdawn": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/redtear1115/marsdawn-mcp/releases/download/v0.2.4/marsdawn.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "marsdawn": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/redtear1115/marsdawn-mcp/releases/download/v0.2.4/marsdawn.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "marsdawn": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/redtear1115/marsdawn-mcp/releases/download/v0.2.4/marsdawn.mcpb"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

export_markdown_to_pdf
Exports a Markdown file to PDF.
open_in_marsdawn
Opens a Markdown file in the MarsDawn app.

What it does

PDF export
Renders Markdown to a paginated PDF in four themes and A4 or Letter.
Open in app
Opens a file in MarsDawn for review, optionally at a given line.
Folder sandbox
Reads and writes only inside folders you allow.
Overwrite guard
Leaves an existing PDF alone unless force is set.
Structured output
Returns the CLI's JSON result to the agent.

Good for

  • Turn an agent's Markdown report into a PDF
  • Open a drafted file in MarsDawn at line 120 for review
  • Export notes with the handbook-style layout
  • Give Claude Desktop PDF export without shell access

Pricing

Free

The marsdawn CLI is free; the MarsDawn app is sold separately on the Mac App Store

Prices change. Check marsdawn.southern-light.dev before you buy.

MarsDawn FAQ

Which platform does it need?

macOS, with the marsdawn CLI installed.

Do I need the MarsDawn app?

Only for open_in_marsdawn; export works without it.

Why are my calls refused?

No allowed folder or root is set, so every call is refused.

Are remote images loaded?

Not by default; allowRemoteImages turns it on.

Is MarsDawn free?

Yes. MarsDawn is free to use.

How do I add MarsDawn to Claude Code?

Run this command in your terminal: claude mcp add marsdawn -- npx -y https://github.com/redtear1115/marsdawn-mcp/releases/download/v0.2.4/marsdawn.mcpb

What are the best alternatives to MarsDawn?

The closest alternatives to MarsDawn are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to MarsDawn

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media