inktomd

# inktomd MCP Server [![smithery badge](https://smithery.ai/badge/hadirizvi093/inktomd)](https://smithery.ai/servers/hadirizvi093/inktomd) Convert any file or URL to clean AI-ready Markdown directly from Claude, Claude Code, Cursor, or any MCP-compatible AI agent. inktomd reduces token usage by up to 63% by converting raw documents to clean Markdown — the format AI models were trained on. ## Tools | Tool | Description | |------|-------------| | `convert_url` | Convert any webpage, article, or web document to Markdown | | `convert_file` | Convert a local file (PDF, Word, Excel, and more) to Markdown | | `convert_youtube` | Extract YouTube video transcript as Markdown | | `convert_arxiv` | Convert ArXiv research paper to Markdown | | `list_supported_formats` | List all supported file formats and URL types | ## Supported Formats **Files:** PDF, Word (.docx), Excel (.xlsx), PowerPoint (.pptx), EPUB, HTML, CSV, JSON, XML, Jupyter (.ipynb), Email (.eml/.msg), ZIP, 7-Zip (.7z) **URLs:** Any webpage, YouTube, ArXiv, Wikipedia, Substack, RSS feeds, Google Docs, GitHub ## Installation & Configuration **Note:** PyPI package coming soon — star the repo to be notified. ### Run from source ```bash git clone https://github.com/hadirizvi093/inktomd cd inktomd/mcp pip install -r requirements.txt python server.py ``` ### Claude Desktop Add to your Claude Desktop config file: **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "inktomd": { "command": "python", "args": ["C:/path/to/inktomd-mcp/server.py"] } } } ``` ### Claude Code ```bash claude mcp add inktomd python C:/path/to/inktomd-mcp/server.py ``` Or add to `.claude/settings.json` in your project: ```json { "mcpServers": { "inktomd": { "command": "python", "args": ["C:/path/to/inktomd-mcp/server.py"] } } } ``` ### Cursor Go to Cursor Settings → Features → MCP → Add new MCP server: ```json { "inktomd": { "command": "python", "args": ["C:/path/to/inktomd-mcp/server.py"] } } ``` ## Usage Examples **Convert a research paper:** > Convert this ArXiv paper to Markdown: https://arxiv.org/abs/2301.07041 **Convert a local PDF:** > Convert /Users/me/documents/report.pdf to Markdown **Extract a YouTube transcript:** > Get the transcript from https://youtube.com/watch?v=dQw4w9WgXcQ **Convert a webpage:** > Convert https://example.com/article to Markdown **Check supported formats:** > What file formats does inktomd support? ## Privacy Files are processed in-memory on inktomd's backend (Google Cloud Run) and deleted immediately after conversion. Nothing is stored. No authentication required. ## Limits - Free tier: 10 conversions per day - Maximum file size: 20MB - Pro plan: Unlimited conversions — inktomd.com/pricing ## Links - Website: https://www.inktomd.com - Pricing: https://www.inktomd.com/pricing - Contact: hadi@inktomd.com