# mcp

Converts office files, PDF documents, and video through the hushvert cloud API in AI coding setups. Useful when your machine lacks LibreOffice or local conversion packages.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: hushvert
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hushvert/mcp
- Updated: 2026-07-16
- HTML: https://affpapa.org/en/nevibecode/mcp/hushvert-mcp

## What it does

The server connects coding agents to the hushvert hosted API over the Model Context Protocol. Its primary tool, `convert_file`, sends a local document to the cloud service and saves the output right next to the source file. For long operations like large video transcoding, the tool yields a `jobId` after `wait_seconds`, which defaults to 120. The agent checks progress via `convert_poll`.

It handles conversions outside browser capabilities. Supported pairs include DOCX or PPTX to PDF, PDF to Word, and video containers like MOV or MKV to MP4. The server refuses audio or image conversion, directing agents to `@hushvert/engine` instead.

With LibreOffice installed, skip this server. Agents on bare machines often fall back to pandoc. Pandoc rebuilds files through LaTeX, discarding heading colors and original fonts. This server avoids installing heavy office suites in CI containers, though it requires `HUSHVERT_API_KEY`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `HUSHVERT_API_KEY`, `HUSHVERT_ALLOWED_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env HUSHVERT_API_KEY=<HUSHVERT_API_KEY> --env HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> --transport stdio hushvert-mcp -- npx -y @hushvert/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add hushvert-mcp --env HUSHVERT_API_KEY=<HUSHVERT_API_KEY> --env HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> -- npx -y @hushvert/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hushvert-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@hushvert/mcp"
            ],
            "env": {
                "HUSHVERT_API_KEY": "<HUSHVERT_API_KEY>",
                "HUSHVERT_ALLOWED_DIR": "<HUSHVERT_ALLOWED_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hushvert-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hushvert/mcp"
            ],
            "env": {
                "HUSHVERT_API_KEY": "<HUSHVERT_API_KEY>",
                "HUSHVERT_ALLOWED_DIR": "<HUSHVERT_ALLOWED_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e HUSHVERT_API_KEY=<HUSHVERT_API_KEY> -e HUSHVERT_ALLOWED_DIR=<HUSHVERT_ALLOWED_DIR> hushvert-mcp npx -y @hushvert/mcp
```
Replace <…> with your own values

## When to use it
- convert DOCX and PPTX files to PDF while preserving layout styling
- turn PDF documents into editable DOCX files
- transcode MKV and MOV video files to MP4
- run office conversions in CI runners without installing LibreOffice

## Example prompts
- Convert report.docx to PDF with hushvert
- Turn slides.pptx into PDF and place the output file next to it
- Transcode archive.mkv to mp4

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4268
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2795
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1248
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1085
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1054
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 779

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md