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````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`):```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):```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`:```bash
npm install -g @un-markdown/mcp-server
Then use unmarkdown-mcp as the command instead of npx:```json
{
"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```bash
# 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-serveron npm
License
MIT. See LICENSE for details.
