# Mac-letterhead

> Mac-letterhead is an open-source MCP server for files and documents. Turn Markdown into PDFs printed inside the safe area of your letterhead. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/easytocloud/mac-letterhead
- **MCP Registry name:** io.github.easytocloud/mac-letterhead
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

```json
{
  "mcpServers": {
    "mac-letterhead": {
      "command": "uvx",
      "args": [
        "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.

## Alternatives

- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Google_sheets](https://ai-powered.com/mcp/google-sheets-3): Google_sheets is a freemium MCP server for files and documents.
- [Onedrive](https://ai-powered.com/mcp/onedrive): Onedrive is a freemium MCP server for files and documents.
- [Zovo Spreadsheet Compare](https://ai-powered.com/mcp/zovo-spreadsheet-compare): Zovo Spreadsheet Compare is an MCP server for files and documents.
- [Video to Audio Converter MCP](https://ai-powered.com/mcp/video-to-audio-converter-mcp): Video to Audio Converter MCP is a free MCP server for design and media.
- [Google_drive](https://ai-powered.com/mcp/google-drive-5): Google_drive is a freemium MCP server for files and documents.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/mac-letterhead
