MCP Document Reader
MCP server that lets AI assistants read DOCX, PDF, Excel, and TXT files.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
python>=3.10
install via uv tool
uv tool install mcp-documents-readerpin mcp v1 for FastMCP compatibility
uv pip install --python "$HOME"/.local/share/uv/tools/mcp-documents-reader/bin/python "mcp<2"
Where the README and reality differ
- README: pip install mcp-documents-reader / uvx mcp-documents-reader works
What worked: pin mcp<2 in the tool env (uv pip install --python ~/.local/share/uv/tools/mcp-documents-reader/bin/python 'mcp<2' giving mcp 1.30.0) before launching
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
uv tool install mcp-documents-reader 2>&1uv pip install --python /home/sbx/.local/share/uv/tools/mcp-documents-reader/bin/python "mcp<2" 2>&1Add it to your agent
claude mcp add mcp-documents-reader -- mcp-documents-readerJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"mcp-documents-reader": {
"command": "mcp-documents-reader",
"args": []
}
}
}Add mcp-documents-reader as an MCP server in your AI assistant's settings, then ask the assistant to read a document by its file path.
What it does
- Get sheet and cell data from Excel filesTested
How to use it
- Connect
mcp-documents-readerto your MCP client. - Ask the assistant to call
read_documentwithfilenameset to <path to .xlsx file>. - Read the sheet and cell text it returns.
- Connect
- Get text and structure from DOCX filesTested
How to use it
- Connect
mcp-documents-readerto your MCP client. - Ask the assistant to call
read_documentwithfilenameset to <path to .docx file>. - Read the headings and paragraphs it returns as text.
- Connect
- Read any supported document with one toolTested
How to use it
- Connect
mcp-documents-readerto your MCP client. - Call
read_documentwithfilenameset to <path to your file>, for example a PDF. - The tool returns the document's text, whatever the file type.
- Connect
- Read DOCX, PDF, Excel and TXT documentsNot shown working
How far pickfit got
Linux x86_64
- Installs
- Connects
- 3 of 4 features work
- Works offline
Good for
- read a DOCX file
- read a PDF file
- read an Excel file
- read a text file
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 1.3.1
An MCP client handshake over stdio listed 1 tool, and a call to read_document returned a result.
Differences the test machine hit
- README: README config uses uvx mcp-documents-reader
In the test: launch via installed binary mcp-documents-reader instead of uvx so replay works with network off