Skip to content
MCP server

Mac-letterhead

Turn Markdown into PDFs printed inside the safe area of your letterhead

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
0.25.0
Listing updated
today

Similar MCP servers

About Mac-letterhead

Mac-letterhead is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Rather than overlaying text, it analyses your letterhead PDF to find the safe printable area around header, footer and logo, then renders Markdown into that space using fonts and colours from a small CSS file. You can mark the area yourself with a rectangle annotation in Preview, let it auto-detect, or fall back to one-inch margins.

The same engine ships as a drag-and-drop Mac droplet, a command-line tool and an MCP server. Everything runs locally on your Mac. WeasyPrint system libraries give full CSS support; without them it falls back to ReportLab with simpler output. Multi-page letterheads with different first-page and later-page designs are supported, and letterheads live under ~/.letterhead by default.

Install through Homebrew, uvx or a double-click .mcpb file for Claude Desktop.

Install

Run in a terminal

claude mcp add mac-letterhead -- uvx Mac-letterhead

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mac-letterhead": {
      "command": "uvx",
      "args": [
        "Mac-letterhead"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mac-letterhead": {
      "command": "uvx",
      "args": [
        "Mac-letterhead"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mac-letterhead": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "Mac-letterhead"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mac-letterhead": {
      "command": "uvx",
      "args": [
        "Mac-letterhead"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mac-letterhead": {
      "command": "uvx",
      "args": [
        "Mac-letterhead"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Safe-area detection
Finds printable space around headers, footers and logos.
Brand CSS
Apply your own fonts and colours.
Three interfaces
Droplet app, CLI and MCP server.
Safe-area preview
Generate a PDF showing cut marks and tint.
Local only
Runs entirely on your Mac.

Good for

  • Ask Claude to draft a proposal on company letterhead
  • Convert a Markdown report to branded PDF
  • Set up one droplet per client brand
  • Merge an existing PDF onto letterhead

Pricing

Open source

Free, open source

Mac-letterhead FAQ

Does it run in the cloud?

No, it runs entirely on your Mac.

What if the letterhead has no marked area?

It auto-detects a safe rectangle with about 40 pt padding, or uses 1-inch margins.

How do I install it?

Homebrew, uvx, or the .mcpb file for Claude Desktop.

What happens without WeasyPrint libraries?

It falls back to ReportLab with simpler output.

Is Mac-letterhead free?

Yes. Mac-letterhead is open source, so you can use and self-host it for free.

How do I add Mac-letterhead to Claude Code?

Run this command in your terminal: claude mcp add mac-letterhead -- uvx Mac-letterhead

What are the best alternatives to Mac-letterhead?

The closest alternatives to Mac-letterhead are SSRS2, Csv, Google_sheets, Onedrive and Zovo Spreadsheet Compare.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers