{
  "markdown": "# Unmarkdown MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@un-markdown/mcp-server)](https://www.npmjs.com/package/@un-markdown/mcp-server)\n[![License: MIT](https://img.shields.io/github/license/UnMarkdown/mcp-server)](https://github.com/UnMarkdown/mcp-server/blob/main/LICENSE)\n[![Smithery](https://smithery.ai/badge/unmarkdown/unmarkdown-mcp)](https://smithery.ai/servers/unmarkdown/unmarkdown-mcp)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server that connects AI assistants to the [Unmarkdown](https://unmarkdown.com) 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.\n\n**Also available as:** [Chrome Extension](https://chromewebstore.google.com/detail/unmarkdown/cfpkknmdjnkeelcdndkgmlmagekofhoa) | [Web App](https://unmarkdown.com) | [REST API](https://docs.unmarkdown.com/api/overview)\n\n## Features\n\n- **Convert markdown** to styled HTML for 8 destinations: Google Docs, Word, Slack, OneNote, Email, Plain Text, generic HTML, and raw HTML\n- **62 visual templates** with light and dark themes (Swiss, Executive, Terminal, GitHub, and more)\n- **Create, read, update** documents in your Unmarkdown library, organized into folders\n- **Publish documents** to shareable public URLs at `unmarkdown.com/d/your-slug`\n- **Track API usage** and quota for the current billing period\n\n## Installation\n\n### Claude Desktop / Claude for macOS\n\nAdd this to your Claude Desktop configuration file:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"unmarkdown\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@un-markdown/mcp-server\"],\n      \"env\": {\n        \"UNMARKDOWN_API_KEY\": \"um_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your Cursor MCP settings (`.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"unmarkdown\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@un-markdown/mcp-server\"],\n      \"env\": {\n        \"UNMARKDOWN_API_KEY\": \"um_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd to your VS Code MCP settings (`.vscode/mcp.json`):\n\n```json\n{\n  \"servers\": {\n    \"unmarkdown\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@un-markdown/mcp-server\"],\n      \"env\": {\n        \"UNMARKDOWN_API_KEY\": \"um_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Global Installation\n\nIf you prefer to install globally instead of using `npx`:\n\n```bash\nnpm install -g @un-markdown/mcp-server\n```\n\nThen use `unmarkdown-mcp` as the command instead of `npx`:\n\n```json\n{\n  \"mcpServers\": {\n    \"unmarkdown\": {\n      \"command\": \"unmarkdown-mcp\",\n      \"env\": {\n        \"UNMARKDOWN_API_KEY\": \"um_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\n### Required\n\n| Variable | Description |\n|----------|-------------|\n| `UNMARKDOWN_API_KEY` | Your Unmarkdown API key (starts with `um_`). Get one from [Settings > API](https://unmarkdown.com) in your Unmarkdown account. |\n\n### Optional\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `UNMARKDOWN_API_URL` | Custom API base URL | `https://api.unmarkdown.com` |\n\n## Usage Examples\n\n### Example 1: Convert a meeting notes draft for Google Docs\n\n> \"Take this markdown and convert it for Google Docs using the Executive template:\n>\n> ```markdown\n> # Q1 Planning Meeting\n>\n> ## Attendees\n> - Sarah Chen (Product)\n> - Mike Torres (Engineering)\n> - Lisa Park (Design)\n>\n> ## Action Items\n> - [ ] Finalize roadmap by Friday\n> - [ ] Schedule design review for new dashboard\n> - [ ] Update stakeholder presentation\n> ```\"\n\nClaude 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.\n\n### Example 2: Create a document in a folder\n\n> \"Create a new document called 'API Changelog - February 2026' in my Release Notes folder with this content, then publish it.\"\n\nClaude will:\n1. Call `create_document` with the title, markdown content, and `folder: \"Release Notes\"`\n2. Call `publish_document` with the returned document ID\n\nThe document is created directly in the specified folder, and you get back a live URL like `https://unmarkdown.com/d/api-changelog-february-2026`.\n\n### Example 3: Update and move a document\n\n> \"Move the Q4 report to the Archive folder and update its title.\"\n\nClaude will:\n1. Call `list_documents` to find the document\n2. Call `update_document` with the new title and `folder: \"Archive\"`\n\n### Example 4: Format markdown for Slack\n\n> \"Convert this project update to Slack format so it looks good when I paste it in our team channel.\"\n\nClaude uses `convert_markdown` with `destination: \"slack\"`, producing output optimized for Slack's rendering (bold, lists, code blocks, emoji support).\n\n### Example 5: Check API usage\n\n> \"How many API calls have I used this month?\"\n\nClaude calls `get_usage` and returns your current usage count, monthly limit, and billing period.\n\n## Tools Reference\n\n| Tool | Description | Read-only | Idempotent |\n|------|-------------|-----------|------------|\n| `convert_markdown` | Convert markdown to styled HTML for any of 8 destinations | Yes | Yes |\n| `create_document` | Create a new document in your library (optionally in a folder) | No | No |\n| `list_documents` | List saved documents with pagination (optionally filter by folder) | Yes | Yes |\n| `get_document` | Fetch a document by ID with full content | Yes | Yes |\n| `update_document` | Modify a document's title, content, template, metadata, or folder | No | Yes |\n| `publish_document` | Publish a document to a shareable public URL | No | Yes |\n| `get_usage` | Check API quota for the current billing month | Yes | Yes |\n\n### Destinations\n\nThe `convert_markdown` tool supports these output formats:\n\n| Destination | Description |\n|-------------|-------------|\n| `google-docs` | Optimized for pasting into Google Docs |\n| `word` | Formatted for Microsoft Word |\n| `slack` | Slack-compatible formatting |\n| `onenote` | Microsoft OneNote compatible |\n| `email` | Email client friendly HTML |\n| `plain-text` | Plain text with ASCII formatting |\n| `generic` | General-purpose styled HTML |\n| `html` | Raw HTML output |\n\n### Templates\n\nPass any template ID to `convert_markdown`, `create_document`, or `update_document`. Popular templates include:\n\n| Template | Category |\n|----------|----------|\n| `swiss` | Free (default) |\n| `mono` | Free |\n| `github` | Free |\n| `terminal` | Free |\n| `executive` | Business (Pro) |\n| `consulting` | Business (Pro) |\n| `startup` | Business (Pro) |\n\nBrowse all 62 templates at [unmarkdown.com/templates](https://unmarkdown.com/templates).\n\n## API Limits\n\n| Plan | Monthly API Calls | Rate Limit |\n|------|-------------------|------------|\n| Free | 1,000 | 10 req/sec |\n| Pro ($8/mo annual) | 10,000 | 30 req/sec |\n\nOverage: $1.00 per 1,000 additional calls (Pro only). Free plan has a hard limit.\n\n## Privacy\n\nThis 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](https://unmarkdown.com/privacy).\n\nSpecifically:\n- **Markdown content** sent via `convert_markdown` is processed and returned immediately. It is not stored on Unmarkdown servers.\n- **Documents** created via `create_document` or `update_document` are stored in your Unmarkdown account and can be deleted at any time.\n- **API keys** authenticate requests and are never logged or shared.\n\nFor the full privacy policy, visit [unmarkdown.com/privacy](https://unmarkdown.com/privacy).\n\n## Support\n\n- **Issues:** [github.com/UnMarkdown/mcp-server/issues](https://github.com/UnMarkdown/mcp-server/issues)\n- **Documentation:** [docs.unmarkdown.com](https://docs.unmarkdown.com)\n- **API Reference:** [docs.unmarkdown.com/api/overview](https://docs.unmarkdown.com/api/overview)\n- **Contact:** [unmarkdown.com/contact](https://unmarkdown.com/contact)\n\n## Development\n\n```bash\n# Clone the repo\ngit clone https://github.com/UnMarkdown/mcp-server.git\ncd mcp-server\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run locally (requires API key)\nUNMARKDOWN_API_KEY=um_your_key node build/index.js\n```\n\n## See Also\n\n- **[Chrome Extension](https://chromewebstore.google.com/detail/unmarkdown/cfpkknmdjnkeelcdndkgmlmagekofhoa)** — Detect and convert markdown on any AI chat page (ChatGPT, Claude, Gemini)\n- **[Web App](https://unmarkdown.com)** — Full editor with 62 templates, publishing, AI actions, and analytics\n- **[REST API](https://docs.unmarkdown.com/api/overview)** — Programmatic access to all conversion and document features\n- **[Smithery](https://smithery.ai/servers/unmarkdown/unmarkdown-mcp)** — Install via the Smithery MCP registry\n- **[npm](https://www.npmjs.com/package/@un-markdown/mcp-server)** — `@un-markdown/mcp-server` on npm\n\n## License\n\nMIT. See [LICENSE](LICENSE) for details.\n",
  "bytes": 9110,
  "sha": "90a3018507bb84608a66719546560cd063974eda5903166b2ff753ffccffc8aa",
  "repo_slug": "unmarkdown/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_unmarkdown_mcp_server_c8837509/readme"
}