UnMarkdown/mcp-server

A Model Context Protocol (MCP) server that connects AI assistants to the Unmarkdown API. Convert markdown to beautifully formatted documents, manage your document library, and publish pages to the web, all from inside Claude, Cursor, VS Code, or any MCP-compatible client.
**Also available as:** Chrome Extension | Web App | REST API
Features
- **Convert markdown** to styled HTML for 8 destinations: Google Docs, Word, Slack, OneNote, Email, Plain Text, generic HTML, and raw HTML
- **62 visual templates** with light and dark themes (Swiss, Executive, Terminal, GitHub, and more)
- **Create, read, update** documents in your Unmarkdown library, organized into folders
- **Publish documents** to shareable public URLs at unmarkdown.com/d/your-slug
- **Track API usage** and quota for the current billing period
Installation
Claude Desktop / Claude for macOS
Add this to your Claude Desktop configuration file:
**macOS:** ~/Library/Application Support/Claude/claude_desktop_config.json
**Windows:** %APPDATA%\Claude\claude_desktop_config.json
Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
VS Code
Add to your VS Code MCP settings (.vscode/mcp.json):
Global Installation
If you prefer to install globally instead of using npx:
Then use unmarkdown-mcp as the command instead of npx:
Configuration
Required
| Variable | Description |
|----------|-------------|
| UNMARKDOWN_API_KEY | Your Unmarkdown API key (starts with um_). Get one from Settings > API in your Unmarkdown account. |
Optional
| Variable | Description | Default |
|----------|-------------|---------|
| UNMARKDOWN_API_URL | Custom API base URL | https://api.unmarkdown.com |
Usage Examples
Example 1: Convert a meeting notes draft for Google Docs
> "Take this markdown and convert it for Google Docs using the Executive template:
>
> "
Claude will use the convert_markdown tool with destination: "google-docs" and template_id: "executive", returning styled HTML ready to paste into Google Docs with proper headings, fonts, and colors.
Example 2: Create a document in a folder
> "Create a new document called 'API Changelog - February 2026' in my Release Notes folder with this content, then publish it."
Claude will:
1. Call create_document with the title, markdown content, and folder: "Release Notes"
2. Call publish_document with the returned document ID
The document is created directly in the specified folder, and you get back a live URL like https://unmarkdown.com/d/api-changelog-february-2026.
Example 3: Update and move a document
> "Move the Q4 report to the Archive folder and update its title."
Claude will:
1. Call list_documents to find the document
2. Call update_document with the new title and folder: "Archive"
Example 4: Format markdown for Slack
> "Convert this project update to Slack format so it looks good when I paste it in our team channel."
Claude uses convert_markdown with destination: "slack", producing output optimized for Slack's rendering (bold, lists, code blocks, emoji support).
Example 5: Check API usage
> "How many API calls have I used this month?"
Claude calls get_usage and returns your current usage count, monthly limit, and billing period.
Tools Reference
| Tool | Description | Read-only | Idempotent |
|------|-------------|-----------|------------|