MCP Server

Use inktomd in Claude Code and Cursor

Install the inktomd MCP server with 9 tools — convert, batch process, and prepare documents for RAG directly from Claude Code and Cursor.

What is the inktomd MCP Server?

The inktomd MCP server lets Claude Code, Cursor, and any MCP-compatible AI agent convert files and URLs to clean Markdown directly — without leaving your development environment. No browser, no copy-paste, no interruption to your workflow.

Available Tools

Tool	Description
convert_url	Convert any webpage, YouTube video, ArXiv paper, Wikipedia article, or web document to Markdown
convert_file	Convert a local file (PDF, Word, Excel, PowerPoint, and more) to Markdown
convert_youtube	Extract the full transcript from any public YouTube video as Markdown
convert_arxiv	Convert any ArXiv research paper to Markdown by URL
list_supported_formats	List all supported file formats and URL types
count_tokens	Count exact tokens for any text across GPT-4o, Claude, Gemini, and other major models
convert_batch	Convert up to 10 URLs to Markdown in a single call
convert_with_metadata	Convert a file or URL and get back content plus word count, token counts across models, and reading time
prepare_for_rag	Convert a document and automatically chunk it into RAG-ready pieces with configurable chunk size and overlap — the flagship tool for developers building retrieval pipelines

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "inktomd": {
      "command": "python",
      "args": ["/path/to/inktomd-mcp/server.py"]
    }
  }
}

Claude Code

claude mcp add inktomd python /path/to/inktomd-mcp/server.py

Cursor

Go to Cursor Settings → Features → MCP → Add new MCP server:

{
  "inktomd": {
    "command": "python",
    "args": ["/path/to/inktomd-mcp/server.py"]
  }
}

Get the MCP Server

View on GitHub →

Clone the repo, install requirements with pip install -r requirements.txt, then add to your AI agent config.

Usage Examples

"Prepare this document for my RAG pipeline with 512 token chunks: https://arxiv.org/abs/2301.07041"

"Count how many tokens this text would use for GPT-4o vs Claude Sonnet: [paste text]"

"Convert this PDF to Markdown: /Users/me/documents/report.pdf"

"Get the transcript from https://youtube.com/watch?v=..."

"Convert this ArXiv paper: https://arxiv.org/abs/2301.07041"

"What file formats does inktomd support?"

Supported Formats

The MCP server supports all 28 formats available on our web interface, including PDF, DOCX, XLSX, PPTX, HTML, EPUB, standard URLs, YouTube URLs, and ArXiv URLs.

See all 28 formats on our homepage →

Privacy Note

Files are processed in-memory on inktomd's backend and deleted immediately. Nothing is stored. No API key required — the MCP server uses inktomd's free public API.