Skip to main content
Glama

mcp-officecli-bridge

Streamable HTTP bridge for OfficeCLI official MCP (officecli mcp stdio) — so it can be used with Gemini Spark Custom App and hosted on Coolify (Tencent Cloud).

Does not re-implement OfficeCLI tools. All tools (create, view, get, query, add, set, remove, move, swap, batch, dump, merge, validate, …) are automatically exposed from upstream.

Gemini Spark --POST /mcp (Streamable HTTP)-->  Express (src/server.ts)  --stdio-->  officecli mcp

Deploy on Coolify (2 minutes)

  1. Coolify → + New Service → Application → select repo mcp_office_cli

  2. Build Pack: Dockerfile — Port: 3000

  3. (Optional) Set domain: mcp.yourdomain.com

  4. Deploy → check https://mcp.yourdomain.com/health → {"status":"ok"}

  5. Gemini Spark → Custom App → MCP URL = https://mcp.yourdomain.com/mcp

Related MCP server: office-addin-mcp

Local test

npm install
npm run build
# butuh officecli terinstall (winget/brew/npm) untuk test lokal, atau pakai Docker
npm start
# test
curl http://localhost:3000/health
curl -X POST http://localhost:3000/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Inspector

npx @modelcontextprotocol/inspector
# URL: http://localhost:3000/mcp  (Streamable HTTP)

Env

Var

Default

Description

PORT

3000

HTTP port

OFFICECLI_BIN

officecli

Path to officecli binary

REQUEST_TIMEOUT_MS

25000

Proxy timeout to upstream

MCP_AUTH_TOKEN

-

If set, requires Authorization: Bearer <token> (todo: wiring)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Exposes Gemini CLI's built-in tools and external MCP proxies through a unified MCP endpoint while providing an OpenAI-compatible API for Gemini models. It features configurable security modes to safely manage file system operations, web searches, and shell command execution.
      24 npm
      138
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for driving Office add-ins (Excel, Word, Outlook, PowerPoint, OneNote) through high-level workflow tools and queries, enabling LLM agents to automate document tasks across Microsoft Office applications via a single Go binary.
      4
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Suite of MCP servers for local-first, governed automation of Microsoft Office files (Excel, PowerPoint, Word) via structured tool calls.
      91 PyPI
      8
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to securely operate Microsoft 365 services, including Outlook email drafting/sending, Teams messaging, and user profile retrieval, through MCP over Streamable HTTP. Deployable on Google Cloud Run with managed authentication via Microsoft Entra ID.
      -