A byte-preserving Office document editing server that lets AI agents read, create, and surgically edit .docx, .pptx, .xlsx, and .pdf files without breaking layouts or untouched content. It also drives the GenOffice desktop app via CDP.
Document extraction: genoffice_extract_text – read text from .docx, .xlsx, .pptx, and .pdf files, preserving slide/table structure.
Word (.docx) tools:
genoffice_docx_blocks – list top-level blocks (paragraphs, headings, tables) with index, type, style, and text.
genoffice_docx_patch – surgically rewrite paragraphs/headings by index, preserving untouched bytes and existing formatting; creates a new file.
genoffice_docx_watermark – add or remove a text watermark, preserving body content; creates a new file.
genoffice_docx_create – create a new .docx from scratch, with optional initial paragraphs and formatting.
genoffice_docx_delete – remove specific blocks by index while preserving all other content; creates a new file.
PowerPoint (.pptx) tools:
genoffice_pptx_slides – list slides and their text elements (id, name, type, text).
genoffice_pptx_patch – replace element text, preserving untouched elements and formatting (font, size, color, bullets); creates a new file.
genoffice_pptx_create – create a new .pptx with one blank slide.
genoffice_pptx_delete – delete elements from a slide while preserving other slides and parts; creates a new file.
GenOffice desktop app control (CDP):
genoffice_app_status – check installation and CDP debug port status.
genoffice_app_launch – launch the app with CDP port open.
genoffice_app_open_file – open a file in the app (macOS).
genoffice_app_screenshot – capture a PNG screenshot of the app window.
genoffice_app_eval – evaluate JavaScript in the app’s page context (read-only by default, mutation possible).
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-genoffice extract the text from this report.docx and summarize it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server that gives AI agents byte-preserving, surgical editing of Office documents through the GenOffice engine packages (Apache-2.0, pure TypeScript, no Electron required).
The core guarantee, inherited from GenOffice's architecture: the original file is the source of truth. Only the blocks you edit are regenerated as OOXML fragments; every untouched paragraph, style, header, comment and zip part keeps its original bytes. Layout never breaks.
Tool | Description |
| Extract readable text from |
| Parse a |
| Rewrite one or more paragraphs with a byte-preserving roundtrip; optional formatting per edit (bold/italic/color/sizePt/font); writes a new file, never touches the original |
| Set/remove a text watermark (header regenerated, body byte-preserved) |
| Create a NEW .docx from scratch (optional initial paragraphs, each with optional formatting) |
| Delete blocks (paragraphs/headings) — remaining blocks byte-preserved |
| List slides and their text elements (id, name, type, text) |
| Replace text of elements on a slide (element-level byte-preserving); optional formatting per edit (bold/italic/color/sizePt/font) |
| Create a NEW .pptx from scratch (one blank slide) |
| Delete elements from a slide (other slides/parts byte-preserved) |
| GenOffice desktop app: installed? CDP port up? (read-only) |
| Launch the app with the CDP debug port (handles auto-update relaunch) |
| Open a file in the app (macOS |
| PNG screenshot of the app window over CDP |
| Evaluate read-only JS in the app page context (DOM) |
More tools (xlsx ops) are on the roadmap.
Related MCP server: Office MCP Server
# from source
npm install
npm start
# as a library in your MCP client (Hermes, Claude Desktop, ...)
npx -y mcp-genofficeConfigure in Hermes (~/.hermes/config.yaml):
mcp_servers:
genoffice:
command: "npx"
args: ["-y", "mcp-genoffice"]
env:
# optional: point at your own genoffice clone; otherwise the server
# auto-clones the pinned revision into ~/.cache/mcp-genoffice/src
# GENOFFICE_SRC: "/path/to/genoffice"
timeout: 300
connect_timeout: 120The GenOffice engine packages are not published to npm and ship as
TypeScript source. The server loads them from a checkout of
genspark-ai/genoffice in two ways:
GENOFFICE_SRC env var — use your own clone (fast, dev mode).
Auto-clone (default) — a shallow, SHA-pinned checkout
(GENOFFICE_PIN in src/engine.ts) plus npm install on first use.
The server runs under the tsx loader so the TS-source engines import cleanly.
npm install
npx tsc --noEmit # typecheck
node tests/client.mjs # end-to-end: spawns the server, lists tools, patches a fixtureThe e2e test uses fixture files from a genoffice clone. By default it points at
/tmp/genoffice; override with FIXTURE_SRC. Unset SERVER_SRC to exercise
the auto-clone path.
Headless engine mode (extract + docx blocks + docx patch)
genoffice_docx_patch rich options (styles, headers, comments, watermark)
PPTX / XLSX tools (pptx-engine, sheets sidecar)
CDP mode: drive the installed GenOffice app (launch, open file, AI edit)
Hermes MCP catalog entry (optional-mcps/genoffice) + usage skill
MIT. The GenOffice engine packages are Apache-2.0 (loaded at runtime from a user-provided or auto-cloned checkout, never bundled).
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AgentDocs (agentdocs.eu): read, search, write, comment on & share Markdown docs.
PandaDoc MCP server for creating, sending, signing, and tracking PandaDoc documents.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/criptogus/mcp-genoffice'
If you have feedback or need assistance with the MCP directory API, please join our Discord server