UnMarkdown/mcp-server

npm version License: MIT Smithery

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

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

VS Code

Add to your VS Code MCP settings (.vscode/mcp.json):

{
  "servers": {
    "unmarkdown": {
      "command": "npx",
      "args": ["-y", "@un-markdown/mcp-server"],
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

Global Installation

If you prefer to install globally instead of using npx:

npm install -g @un-markdown/mcp-server

Then use unmarkdown-mcp as the command instead of npx:

{
  "mcpServers": {
    "unmarkdown": {
      "command": "unmarkdown-mcp",
      "env": {
        "UNMARKDOWN_API_KEY": "um_your_api_key_here"
      }
    }
  }
}

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:

# Q1 Planning Meeting

## Attendees
- Sarah Chen (Product)
- Mike Torres (Engineering)
- Lisa Park (Design)

## Action Items
- [ ] Finalize roadmap by Friday
- [ ] Schedule design review for new dashboard
- [ ] Update stakeholder presentation
```"

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
convert_markdown	Convert markdown to styled HTML for any of 8 destinations	Yes	Yes
create_document	Create a new document in your library (optionally in a folder)	No	No
list_documents	List saved documents with pagination (optionally filter by folder)	Yes	Yes
get_document	Fetch a document by ID with full content	Yes	Yes
update_document	Modify a document's title, content, template, metadata, or folder	No	Yes
publish_document	Publish a document to a shareable public URL	No	Yes
get_usage	Check API quota for the current billing month	Yes	Yes

Destinations

The convert_markdown tool supports these output formats:

Destination	Description
google-docs	Optimized for pasting into Google Docs
word	Formatted for Microsoft Word
slack	Slack-compatible formatting
onenote	Microsoft OneNote compatible
email	Email client friendly HTML
plain-text	Plain text with ASCII formatting
generic	General-purpose styled HTML
html	Raw HTML output

Templates

Pass any template ID to convert_markdown, create_document, or update_document. Popular templates include:

Template	Category
swiss	Free (default)
mono	Free
github	Free
terminal	Free
executive	Business (Pro)
consulting	Business (Pro)
startup	Business (Pro)

Browse all 62 templates at unmarkdown.com/templates.

API Limits

Plan	Monthly API Calls	Rate Limit
Free	1,000	10 req/sec
Pro ($8/mo annual)	10,000	30 req/sec

Overage: $1.00 per 1,000 additional calls (Pro only). Free plan has a hard limit.

Privacy

This MCP server sends your markdown content and document data to the Unmarkdown API (api.unmarkdown.com) for processing. No data is stored locally by the MCP server itself. All data handling is governed by the Unmarkdown Privacy Policy.

Specifically:

• Markdown content sent via convert_markdown is processed and returned immediately. It is not stored on Unmarkdown servers.
• Documents created via create_document or update_document are stored in your Unmarkdown account and can be deleted at any time.
• API keys authenticate requests and are never logged or shared.

For the full privacy policy, visit unmarkdown.com/privacy.

Support

• Issues: github.com/UnMarkdown/mcp-server/issues
• Documentation: docs.unmarkdown.com
• API Reference: docs.unmarkdown.com/api/overview
• Contact: unmarkdown.com/contact

Development

# Clone the repo
git clone https://github.com/UnMarkdown/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally (requires API key)
UNMARKDOWN_API_KEY=um_your_key node build/index.js

See Also

• Chrome Extension — Detect and convert markdown on any AI chat page (ChatGPT, Claude, Gemini)
• Web App — Full editor with 62 templates, publishing, AI actions, and analytics
• REST API — Programmatic access to all conversion and document features
• Smithery — Install via the Smithery MCP registry
• npm — @un-markdown/mcp-server on npm

License

MIT. See LICENSE for details.