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 14 (Sonoma) 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 (15)

† open_in_office hands the file to the TruePath Office Mac app over its truepath-office:// URL scheme, so after reading or editing a document headlessly here you can finish it in the GUI. It requires the TruePath Office app v1.0.6 or newer (the version that registers the scheme). If the app isn't installed, the tool returns a link to get it rather than opening anything. macOS only. Every other tool is fully local and needs no app.

CLI

The same engine is available as a command-line tool:

.build/release/truepath detect xlsx                 # → Spreadsheet (spreadsheet)
.build/release/truepath formula "=SUM(A1:A3)" ...   # evaluate a formula
.build/release/truepath word --extract report.docx  # structured DOCX JSON

Run truepath with no arguments for the full command list.

Quick test

printf '%s\n%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
  | .build/release/truepath-office-mcp 2>/dev/null

Architecture

truepath-office-mcp (executable)
  └─ TruePathMCPLib  (JSON-RPC 2.0 + tool handlers)
       └─ TruePathCore  (Foundation-only document engine)

truepath (CLI) ──────────────────────────────────────┘

stdin → JSON-RPC 2.0 → MCPServer → ToolHandlers → TruePathCore → result → stdout
stderr → diagnostic logs

Each sub-package (TruePathCore/, TruePathMCP/, TruePathCLI/) keeps its own Package.swift and test suite; cd <pkg> && swift test runs them in isolation.

License

MIT © Joy Truepath Pte. Ltd.