# MarsDawn

> MarsDawn is a free MCP server for files and documents. Export Markdown to PDF and open files in the MarsDawn Mac app from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** macOS, CLI
- **Website:** https://marsdawn.southern-light.dev/cli/
- **Repository:** https://github.com/redtear1115/marsdawn-mcp
- **MCP Registry name:** dev.southern-light.mcp/marsdawn
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/marsdawn
