@mioffice/mcp

MCP (Model Context Protocol) server for MiOffice — AI Office Suite for PDF, Word, Images & Video. 100% privacy — files never leave your browser.

Quick Setup (Claude Desktop)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mioffice": {
      "command": "npx",
      "args": ["-y", "@mioffice/mcp"]
    }
  }
}

Then ask Claude: "Merge these two PDFs", "Compress this image", "Remove the background from this photo".

Claude Code Setup

claude mcp add mioffice -- npx -y @mioffice/mcp

15 Tools

File Processing (Tier 1)

| Tool | Description | |------|-------------| | mioffice_pdf_merge | Merge 2-20 PDFs into one | | mioffice_pdf_split | Extract pages from PDF | | mioffice_pdf_compress | Compress PDF (low/medium/high) | | mioffice_word_to_pdf | Convert DOCX/DOC → PDF | | mioffice_excel_to_pdf | Convert XLSX/XLS → PDF | | mioffice_image_compress | Compress images (PNG/JPG/WebP) | | mioffice_image_resize | Resize to specific dimensions | | mioffice_image_convert | Convert between formats | | mioffice_image_rotate | Rotate by any angle | | mioffice_heic_to_jpg | Convert iPhone HEIC → JPG | | mioffice_remove_background | AI background removal | | mioffice_upscale_image | AI 2-4x upscaling |

Navigation (Tier 2)

| Tool | Description | |------|-------------| | mioffice_open_tool | Get URL for any of 66+ tools | | mioffice_list_tools | Browse full tool catalog | | mioffice_pdf_editor | Open PDF Editor Pro |

Modes

Set MIOFFICE_MODE environment variable:

• process (default) — Reads local files, uploads to mioffice.ai API, writes results back to disk.
• navigate — Returns tool URLs only. Zero server load, pure navigation.

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | MIOFFICE_MODE | process | process or navigate | | MIOFFICE_BASE_URL | https://mioffice.ai | API base URL | | MIOFFICE_TIMEOUT_IMAGE | 30000 | Image processing timeout (ms) | | MIOFFICE_TIMEOUT_PDF | 180000 | PDF processing timeout (ms) | | MIOFFICE_TIMEOUT_AI | 120000 | AI processing timeout (ms) |

Rate Limits

| Processor | Requests/Hour | Max File Size | |-----------|:---:|:---:| | Image | 20 | 25 MB | | PDF | 15 | 100 MB | | AI | 10 | 10 MB |

ChatGPT Custom GPT

Import openapi.json into the ChatGPT GPT Builder as an Action to expose the same API endpoints.

Development

npm install
npm run build        # Compile TypeScript
npm run dev          # Run with tsx (hot reload)
npm run generate-openapi  # Regenerate openapi.json

License

MIT