TruePath Office — MCP server (truepath-office-mcp)

Let your AI read and edit Office documents locally. Files never leave your Mac.

An MCP server that lets your AI agent — Claude Desktop, Claude Code, Codex, Cursor, Windsurf, or any MCP client — process Word (DOCX), Excel (XLSX), PowerPoint (PPTX) and PDF files on your machine: evaluate spreadsheet formulas, read & write workbooks and slide decks, extract structured DOCX content, and merge / split / protect PDFs.

Built and maintained by Joy Truepath Pte. Ltd., the team behind the TruePath Office Mac app (on the Mac App Store). The engine here (TruePathCore) is the same headless, Foundation-only, zero- dependency core that ships inside the app — open-sourced for transparency and standalone use.

Privacy

• 100% local. The server runs on your Mac and makes no network calls.
• No telemetry, no analytics, no phone-home.
• Works fully offline, forever, with no key or account.

Requirements

• macOS 13 (Ventura) or newer
• Swift 6 / Xcode 16 toolchain (to build) — xcode-select --install or swift.org

Build

git clone https://github.com/JoyTruepath/truepath-office-mcp.git
cd truepath-office-mcp
swift build -c release

This produces two binaries under .build/release/:

• truepath-office-mcp — the MCP stdio server
• truepath — a standalone CLI for the same engine

Get the server's absolute path for the config snippets below:

echo "$(pwd)/.build/release/truepath-office-mcp"

Hook it up

Use the absolute path printed above wherever you see /path/to/....

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "truepath-office": { "command": "/path/to/truepath-office-mcp/.build/release/truepath-office-mcp" } } }

Claude Code

claude mcp add truepath-office -- "/path/to/truepath-office-mcp/.build/release/truepath-office-mcp"

Codex — ~/.codex/config.toml

[mcp_servers.truepath-office]
command = "/path/to/truepath-office-mcp/.build/release/truepath-office-mcp"

Cursor / Windsurf — MCP settings (see each IDE's docs for the file location)

{ "mcpServers": { "truepath-office": { "command": "/path/to/truepath-office-mcp/.build/release/truepath-office-mcp" } } }

Restart the host, then ask your agent something like: "Use truepath-office to read the body text of ~/Documents/report.docx."

Tools (20)

... View full README on GitHub