Skip to main content
Glama
Document Reading and Converter Tool

Document Reading and Converter Tool

by mffrydman

Document Reading and Converter Tool

The goal is to have a tool that can read and edit files, using Cursor or Claude Desktop.

The filesystem MCP already allows reading, writing and editing documents, but is limited in that it cannot:

  • Read pdfs or docx files

  • Reads the full document, which can cause context overflow

To address these issues, we create:

  • A fresh doc-reading-mcp mcp service allowing for document conversions between pdf, docx and markdown.

Features

  • PDF to Markdown conversion using marker-pdf

  • DOCX to Markdown conversion using pandoc

  • Markdown to DOCX conversion using pandoc

  • Markdown to PDF conversion using pandoc

Related MCP server: mcp-document-converter

Prerequisites

Installation

uv add doc-reading-mcp

Or install directly from the source:

uv add git+https://github.com/mffrydman/doc-reading-mcp.git

Usage

Run as a standalone server

uv run mcp install -m doc_reading_mcp

Or run directly:

uv run -m doc_reading_mcp

Use with MCP Inspector

npx @modelcontextprotocol/inspector uvx run -m doc_reading_mcp

Configure in Claude Desktop, Cursor or Windsurf

Add this to your MCP Configuration:

{
    "mcpServers": {
        "doc-reading-mcp": {
            "command": "uvx",
            "args": [
                "doc-reading-mcp",
            ]
        }
    }
}

Run in Cursor/Windsurf/Claude using the following configuration:

    "doc-reading-mcp": {
        "command": "uv",
        "args": [
            "--directory",
            "/absolute/path/to/mffrydman/doc-reading-mcp",
            "run",
            "-m",
            "doc_reading_mcp"
        ]
    }

Replace

  • /absolute/path/to/ with the actual path on your system.

Available Tools

1 tool
convert_documentA

Convert a document between different formats

Args: input_path (str): Absolute path to the input document output_format (OutputFormat): Target format to convert to. One of: "pdf", "docx" or "md"

Returns: str: A message indicating success or failure of the conversion

Notes: This tool is especially useful as a conversion step to make PDF and DOCX files readable in plain text format by converting them to Markdown. This enables easier processing, analysis and interaction with the content of these document formats.

For conversions to PDF or DOCX, the file is saved in the same directory as the input file,
with the same filename but with the extension changed to match the ouput format.

For conversions to Markdown, the markdown file and any images extracted are placed in a folder
that has the same name as the original file (without extension). The markdown file itself
will have the same name as the original file but with the .md extension.

For example:
- Converting /path/to/document.pdf to docx will save as /path/to/document.docx
- Converting /path/to/document.pdf to md will create a folder /path/to/document/
    containing document.md and any extracted images

Inputs: input_path (required), output_format (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no risk of confusing it with other tools.

    Naming Consistency5/5

    The single tool uses a clear verb_noun convention ('convert_document').

    Tool Count2/5

    The server name implies both reading and conversion, but only one conversion tool is provided, making the surface too thin.

    Completeness2/5

    No reading or retrieval tool is exposed despite the server's stated purpose, leaving a significant gap for document-reading workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches