Skip to content
mcwaddams
Office Space film slate with the iconic red Swingline stapler

mcwaddams

I was told there would be document extraction.
Get Started View on GitHub

The Situation

Section titled “The Situation”

You have Office documents. Lots of them. Some are modern .docx files. Others are .doc files from 1997 that predate Unicode. Your AI agent needs to read them, but native PDF-to-text tools just stare blankly.

mcwaddams handles what nobody else wants to touch.

20 Tools

Extract text, tables, images, metadata. Analyze structure. Convert to Markdown. Index for on-demand fetching.

Legacy Support

.doc, .xls, .ppt — the formats everyone forgot about until they need them. We didn’t forget.

Smart Fallbacks

When python-docx chokes, mammoth steps in. When openpyxl fails, pandas takes over. No silent failures.

MCP Resources

Index once, fetch chapters/sheets/slides on demand. Keep your context window manageable.

Quick Install

Section titled “Quick Install”
Terminal window
# With uvx (recommended)
uvx mcwaddams


# Add to Claude Code
claude mcp add mcwaddams "uvx mcwaddams"

Documentation Structure

Section titled “Documentation Structure”

This documentation follows the Diátaxis framework:

Tutorials Learn by doing. Step-by-step guides for common workflows.
How-To Guides Solve specific problems. Task-oriented recipes.
Reference Look up tool parameters and return values.
Explanation Understand the architecture and design decisions.

TPS Reports

Section titled “TPS Reports”

“Did you get the memo about the TPS reports?”

We take testing seriously. Check out our Test Dashboard for live results, or browse the Torture Tests where we threw 301 random Office documents at mcwaddams.

Result: 99.3% success rate. The 2 failures were empty/corrupt files.

Named for Milton Waddams, who was relocated to the basement with the legacy documents.


”I could set the building on fire…”
🎉

Flair Earned!

Badge Name

🎖️

You earned your first flair!

What should we call you?
VISITOR
I Was Told There Would Be Extraction
I Was Told There Would Be Extraction Started your mcwaddams journey
Basement Dweller
Basement Dweller Learned about Milton and the legacy documents
PC Load Letter
PC Load Letter Successfully installed mcwaddams
Case of the Mondays
Case of the Mondays Completed the quick start guide
TPS Report Expert
TPS Report Expert Read the complete tools reference
The Bobs Approved
The Bobs Approved Understood the architecture
Did You Get The Memo?
Did You Get The Memo? Checked the test dashboard
O Face
O Face Witnessed the torture test results
I Have Your Stapler
I Have Your Stapler Found the credits and attributions
Jump to Conclusions
Jump to Conclusions Completed your first extraction tutorial
Spreadsheet Survivor
Spreadsheet Survivor Mastered table extraction
37 Pieces of Flair
37 Pieces of Flair Discovered the flair leaderboard
Cinema Enthusiast
Cinema Enthusiast Explored the Office Space gallery
0 / 13 pieces of flair

"We need to talk about your document processing..."

— Stan, Manager

Current page: I Was Told There Would Be Extraction