Skip to content
Back to search

opendocswork-mcp

Rust-native MCP server for Office document processing (Excel, Word, PowerPoint). Sub-millisecond, local-first, open source.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aimino-tech--opendocswork-mcp/badge.svg)](/listings/aimino-tech--opendocswork-mcp)

HTML

<a href="/listings/aimino-tech--opendocswork-mcp"><img src="/api/listings/aimino-tech--opendocswork-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

cargo install office-oxide-mcp

Or download from [GitHub Releases](https://github.com/Aimino-Tech/office-oxide-mcp/releases).

Claude Desktop

{
  "mcpServers": {
    "office": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  }
}

Cursor

{
  "mcpServers": {
    "office-oxide-mcp": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  }
}

VS Code (Copilot)

{
  "servers": {
    "office-oxide-mcp": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  }
}

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 183 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # office-oxide-mcp
  2. [![GitHub stars](https://img.shields.io/github/stars/Aimino-Tech/opendocswork-mcp?style=social)](https://github.com/Aimino-Tech/opendocswork-mcp/stargazers)
  3. [![GitHub forks](https://img.shields.io/github/forks/Aimino-Tech/opendocswork-mcp?style=social)](https://github.com/Aimino-Tech/opendocswork-mcp/network/members)
  4. [![GitHub issues](https://img.shields.io/github/issues/Aimino-Tech/opendocswork-mcp)](https://github.com/Aimino-Tech/opendocswork-mcp/issues)
  5. [![GitHub pull requests](https://img.shields.io/github/issues-pr/Aimino-Tech/opendocswork-mcp)](https://github.com/Aimino-Tech/opendocswork-mcp/pulls)
  6. **Rust-native MCP server for Office document processing (Excel, Word, PowerPoint, PDF).**
  7. Sub-millisecond, local-first, open source — the "open source Aspose."
  8. > **PDFs are a pain.** We live in bureaucratic countries where every form asks for your name, address, and date of birth — over and over. Bank applications, tax forms, insurance claims, government permits, rental agreements. Same fields, different PDFs, endless typing.
  9. > **Stop filling forms by hand.** Let office-oxide-mcp do it in milliseconds — whether it's a simple AcroForm, a complex XFA form, or a flat scanned PDF where you need coordinates. Your LLM reads the form, you approve, it fills. Done.
  10. <p align="center">
  11. <a href="https://discord.gg/GVYVCwWX"><img src="https://img.shields.io/discord/1514222622215241729?color=5865F2&label=Join%20Discord&logo=discord&logoColor=white" alt="Discord"></a>
  12. <a href="https://github.com/Aimino-Tech/office-oxide-mcp/discussions"><img src="https://img.shields.io/badge/GitHub-Discussions-%23181717?logo=github" alt="GitHub Discussions"></a>
  13. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT%2FApache--2.0-blue" alt="License"></a>
  14. </p>
  15. > [!TIP]
  16. > Be with us!
  17. >
  18. > | [<img alt="Discord link" src="https://img.shields.io/discord/1514222622215241729?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square" width="156px" />](https://discord.gg/GVYVCwWX) | Join our [Discord community](https://discord.gg/GVYVCwWX) to ask questions, share ideas, and get help with office-oxide-mcp. |
  19. > | :----- | :----- |
  20. > | [<img alt="GitHub Discussions" src="https://img.shields.io/badge/GitHub-Discussions-181717?style=flat-square&logo=github&labelColor=black" width="156px" />](https://github.com/Aimino-Tech/opendocswork-mcp/discussions) | Prefer GitHub? Start a [discussion](https://github.com/Aimino-Tech/opendocswork-mcp/discussions) or open an issue. |
  21. > | [<img alt="GitHub Follow" src="https://img.shields.io/github/followers/Aimino-Tech?style=flat-square&logo=github&labelColor=black&color=24292f" width="156px" />](https://github.com/Aimino-Tech) | Follow [@Aimino-Tech](https://github.com/Aimino-Tech) on GitHub for more projects. |
  22. <p align="center">
  23. <a href="https://discord.gg/GVYVCwWX"><img src="https://discord.com/api/v10/guilds/1514222622215241729/widget.png?style=banner2" alt="Discord Widget"></a>
  24. </p>
  25. ---
  26. ## Quick Start
  27. ```bash
  28. cargo install office-oxide-mcp
  29. ```
  30. Or download from [GitHub Releases](https://github.com/Aimino-Tech/office-oxide-mcp/releases).
  31. ### Claude Desktop
  32. ```json
  33. {
  34. "mcpServers": {
  35. "office": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  36. }
  37. }
  38. ```
  39. ### Cursor
  40. ```json
  41. {
  42. "mcpServers": {
  43. "office-oxide-mcp": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  44. }
  45. }
  46. ```
  47. ### VS Code (Copilot)
  48. ```json
  49. {
  50. "servers": {
  51. "office-oxide-mcp": { "command": "office-oxide-mcp", "args": ["--transport", "stdio"] }
  52. }
  53. }
  54. ```
  55. ---
  56. ## Use Cases
  57. Every document below was generated by office-oxide-mcp — click to download.
  58. | # | Format | Use Case | Skill | Preview |
  59. |---|--------|----------|-------|---------|
  60. | 1 | XLSX | [Profit & Loss Statement](showcase/generated/01-posch-energy-pnl/01-posch-energy-pnl.xlsx) | `excel.basic` | <img src="showcase/previews/01-pnl.png" width="180" alt="P&L"> |
  61. | 2 | XLSX | [Executive KPI Dashboard](showcase/generated/02-meyer-automotive-kpi/02-meyer-automotive-kpi.xlsx) | `excel.basic` | <img src="showcase/previews/02-kpi.png" width="180" alt="KPI"> |
  62. | 3 | XLSX | [Budget vs Actual Variance](showcase/generated/03-liebermann-health-budget/03-liebermann-health-budget.xlsx) | `excel.basic` | <img src="showcase/previews/03-budget.png" width="180" alt="Budget"> |
  63. | 4 | XLSX | [Balance Sheet with Ratios](showcase/generated/04-wolfsburg-financial-balance/04-wolfsburg-financial-balance.xlsx) | `excel.basic` | <img src="showcase/previews/04-balance.png" width="180" alt="Balance"> |
  64. | 5 | XLSX | [Revenue Forecast](showcase/generated/10-hoffmann-machine/10-hoffmann-machine.xlsx) | `excel.basic` | <img src="showcase/previews/10-forecast.png" width="180" alt="Forecast"> |
  65. | 6 | XLSX | [Cost Analysis](showcase/generated/11-beck-energy/11-beck-energy.xlsx) | `excel.basic` | <img src="showcase/previews/11-cost.png" width="180" alt="Cost"> |
  66. | 7 | DOCX | [Invoice](showcase/generated/05-thyssen-steel/05-thyssen-steel.xlsx) | `word.invoice` | <img src="showcase/previews/05-invoice.png" width="180" alt="Invoice"> |
  67. | 8 | DOCX | [Annual Business Report](showcase/generated/15-meyer-automotive-report/15-meyer-automotive-report.docx) | `word.report` | <img src="showcase/previews/15-report.png" width="180" alt="Report"> |
  68. | 9 | DOCX | [IT Service Agreement](showcase/generated/17-liebermann-health-contract/17-liebermann-health-contract.docx) | `word.report` | <img src="showcase/previews/17-contract.png" width="180" alt="Contract"> |
  69. | 10 | DOCX | [Digital Strategy Report](showcase/generated/16-wolfsburg-digital-strategy/16-wolfsburg-digital-strategy.docx) | `word.report` | <img src="showcase/previews/16-strategy.png" width="180" alt="Strategy"> |
  70. | 11 | PDF | [Financial Report Export](showcase/generated/06-bauer-construction/06-bauer-construction.xlsx) | `office_export_pdf` | <img src="showcase/previews/06-pdfexport.png" width="180" alt="PDF"> |
  71. | 12 | PPTX | [Strategy Consulting Pitch Deck](showcase/generated/01-strategy-consulting-pitch/01-strategy-consulting-pitch.pptx) | `ppt.deck` | <img src="showcase/previews/01-strategy-consulting-pitch.png" width="180" alt="Strategy"> |
  72. | 13 | PPTX | [CFO Quarterly Business Review](showcase/generated/02-cfo-qbr-review/02-cfo-qbr-review.pptx) | `ppt.deck` | <img src="showcase/previews/02-cfo-qbr-review.png" width="180" alt="CFO QBR"> |
  73. | 14 | PPTX | [Product Launch Strategy Deck](showcase/generated/03-product-launch-strategy/03-product-launch-strategy.pptx) | `ppt.deck` | <img src="showcase/previews/03-product-launch-strategy.png" width="180" alt="Product"> |
  74. | 15 | PPTX | [M&A Target Analysis Deck](showcase/generated/04-ma-target-analysis/04-ma-target-analysis.pptx) | `ppt.deck` | <img src="showcase/previews/04-ma-target-analysis.png" width="180" alt="M&A"> |
  75. | 16 | PPTX | [Digital Transformation Roadmap](showcase/generated/05-digital-transformation/05-digital-transformation.pptx) | `ppt.deck` | <img src="showcase/previews/05-digital-transformation.png" width="180" alt="DX"> |
  76. > **Interactive showcase → [`showcase/use-cases.html`](showcase/use-cases.html)** with full prompts, JSON-RPC calls, and details.
  77. ---
  78. ## Tool Overview
  79. | Tool | Description | Inputs |
  80. |---|---|---|
  81. | `list_formats` | All supported Office formats + capabilities | — |
  82. | `get_document_info` | File metadata (format, size, readability) | `file_path` |
  83. | `office_read` | Read content → JSON / Markdown / Chunks / Text | `file_path`, `output_format` |
  84. | `office_fill_pdf_form` | Fill AcroForm/XFA form fields in a PDF | `file_path`, `output_path`, `fields` |
  85. | `office_list_pdf_fields` | List all form fields in a PDF with values | `file_path` |
  86. | `office_overlay_pdf_text` | Insert text at coordinates on flat PDFs | `file_path`, `output_path`, `fields` |
  87. | `office_analyze_pdf_layout` | Analyze PDF layout for overlay coordinates | `file_path` |
  88. | `increment` | Increment counter (demo) | — |
  89. | `get_value` | Get current counter value (demo) | — |
  90. ### Full Suite
  91. **AI Reading:** `to_md`, `to_json`, `to_chunks`, `excel_schema`, `coherence_check`
  92. **Excel Write:** `office_create_xlsx`, `office_write_cell`, `office_write_range`, `office_format_range`, `office_create_chart`, `office_create_pivot`, `office_add_sheet`, `office_rename_sheet`, `office_delete_sheet`, `office_merge_cells`, `office_set_column_width`, `office_apply_conditional_format`
  93. **Word Write:** `office_create_docx`, `office_write_docx_from_md`, `office_replace_text`, `office_set_style`, `office_add_table`, `office_add_image`, `office_add_header_footer`, `office_add_toc`, `office_add_comment`, `office_accept_changes`
  94. **PPT Write:** `office_create_pptx`, `office_add_slide`, `office_set_slide_layout`, `office_add_text_box`, `office_add_chart`, `office_add_image`
  95. **Skills System:** `skill_run`, `skill_list`, `skill_validate`, `skill_register`
  96. **Coherence Engine:** `office_propagate_edit`, `office_check_consistency`
  97. **PDF:** `office_read` (markdown/text/json/chunks), `office_fill_pdf_form`, `office_list_pdf_fields`, `office_overlay_pdf_text`, `office_analyze_pdf_layout`, `office_export_pdf`
  98. ---
  99. ## Architecture
  100. ```
  101. ┌────────────────────────────────────────────────────────┐
  102. │ Tool Layer │
  103. │ AI Reading · Excel/Word/PPT · PDF · Skills · Coherence│
  104. ├────────────────────────────────────────────────────────┤
  105. │ Format Engines │
  106. │ calamine · rust_xlsxwriter · rdocx · office_oxide │
  107. │ 6 Office formats + PDF (lopdf) │
  108. ├────────────────────────────────────────────────────────┤
  109. │ ZIP + XML + PDF Layer │
  110. │ quick-xml (zero-copy) · zip · zlib-ng (SIMD) · lopdf│
  111. ├────────────────────────────────────────────────────────┤
  112. │ Semantic Layer │
  113. │ Entity DAG · BFS propagation · Stale detection │
  114. └────────────────────────────────────────────────────────┘
  115. ```
  116. ---
  117. ## Performance Benchmarks
  118. | Operation | Python | office-oxide-mcp | Speedup |
  119. |---|---|---|---|
  120. | 10M cell XLSX read (openpyxl) | 239s | ~25s | **~10×** |
  121. | 100K cell XLSX write (openpyxl) | 1.8s | 152ms | **~12×** |
  122. | DOCX read mean (6K docs) | 11.8ms | 0.8ms | **~14×** |
  123. | PPTX read mean (323 slides) | 32.5ms | 0.7ms | **~46×** |
  124. | MCP tool call (FastMCP) | 3ms | 0.38ms | **~6×** |
  125. | Cold start | 1-5s | <50ms | **~100×** |
  126. | Memory (idle) | 42.7MB | <2MB | **~20×** |
  127. ---
  128. ## Build
  129. ```bash
  130. cargo build # Debug
  131. cargo build --release # Release
  132. cargo clippy # Lint
  133. cargo doc --open # Docs
  134. ```
  135. ## Contributing
  136. See [CONTRIBUTING.md](CONTRIBUTING.md). All contributions welcome.
  137. ## License
  138. MIT OR Apache-2.0 — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.