# Carbone MCP

> Carbone MCP is a freemium MCP server for files and documents. Generate PDF, Word, Excel and PowerPoint files from templates and JSON via Carbone. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, self-hosted, CLI
- **Website:** https://carbone.io
- **Repository:** https://github.com/carboneio/carbone-mcp
- **MCP Registry name:** io.carbone/carbone-mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

Carbone fills templates written in Word, Excel, PowerPoint, LibreOffice, HTML or Markdown with `{d.field}` tags, so the assistant supplies JSON data and gets back a finished file. The README says it can also fill an existing PDF form, convert between formats, and add passwords, watermarks, PDF/A output and page ranges.

Template management is part of the toolset: an assistant can upload, version, categorize and deploy templates, and ask which data a template expects before rendering. Batches of up to 100 documents per request are supported, either collected by the assistant on the hosted server or delivered to your own webhook, with translation, time zones and currency conversion at rates you provide.

The hosted server at mcp.carbone.io needs nothing installed and signs in with a Carbone account. A local `npx carbone-mcp` package also reads and writes local paths, and a Docker option lets you run your own server, including against an on-premise Carbone API.

## Features

- **Template filling:** Merges JSON data into Word, Excel, PowerPoint, HTML or Markdown templates, or fills an existing PDF form.
- **Format conversion:** Converts DOCX, XLSX, PPTX, HTML, SVG, Markdown or PDF into PDF, images, CSV, ODT and other outputs.
- **PDF finishing:** Adds passwords, watermarks, PDF/A compliance and page ranges, with a choice of converter.
- **Batch rendering:** Produces up to 100 documents per request, collected by the assistant or sent to your webhook.
- **Localization:** Handles translations, time zones and currency conversion at rates you give.
- **Template library:** Uploads, versions, categorizes, deploys and downloads templates, and reports what data each one expects.

## Good for

- Turn a CRM deal into a quote PDF with a watermark
- Generate one certificate per row of a spreadsheet as a ZIP of PDFs
- Render an invoice in several languages with converted prices
- Build a monthly statement from payment-system data and check the layout as a PNG
- Archive selected contract pages as PDF/A

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http carbone-mcp https://mcp.carbone.io
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.carbone.io
```

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

```json
{
  "mcpServers": {
    "carbone-mcp": {
      "url": "https://mcp.carbone.io"
    }
  }
}
```

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

```json
{
  "servers": {
    "carbone-mcp": {
      "type": "http",
      "url": "https://mcp.carbone.io"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carbone-mcp": {
      "serverUrl": "https://mcp.carbone.io"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carbone-mcp": {
      "type": "http",
      "url": "https://mcp.carbone.io"
    }
  }
}
```

## FAQ

### Do I need an account?

Yes. You sign in with a Carbone account, which is free to create. For the local package an API key from account.carbone.io is required, unless you point it at an on-premise server.

### Is there a free tier?

Without a plan you get unlimited watermarked PDFs. The Free plan adds every output format without a watermark, up to 100 documents a month.

### How can I run it?

Use the hosted server at mcp.carbone.io, the local npx package over stdio, or a Docker server of your own.

### Which file inputs can it take?

The hosted server accepts URLs, base64, ChatGPT attachments and upload URLs; the local package also reads local paths and saves documents to disk.

### Is Carbone MCP free?

Carbone MCP has a free plan, with paid plans for more usage or features.

### How do I add Carbone MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http carbone-mcp https://mcp.carbone.io

### What are the best alternatives to Carbone MCP?

The closest alternatives to Carbone MCP 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/carbone-mcp
