mcp-server

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

{
  "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: ``markdown # 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.