Log inSubmit server
Hushvert MCP logo

Hushvert MCP

by hushvert

Converts supported office, document, PDF, and video formats through a hosted API, with results written to local paths.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Hushvert MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hushvert-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hushvert/mcp"
      ],
      "env": {
        "HUSHVERT_API_KEY": "YOUR_VALUE_HERE",
        "HUSHVERT_API_BASE": "YOUR_VALUE_HERE",
        "HUSHVERT_DEFAULT_WAIT_SECONDS": "YOUR_VALUE_HERE",
        "HUSHVERT_MAX_JOBS_PER_SESSION": "YOUR_VALUE_HERE",
        "HUSHVERT_ALLOWED_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The hushvert/mcp MCP server exposes hushvert.com’s hosted file-conversion API to MCP-compatible coding agents. It reads a local input file, uploads supported server-only conversions, writes the result locally, and can resume longer jobs through polling. Use it for office-to-PDF, PDF-to-Word, document interchange, and video conversions when a suitable local converter is unavailable or fidelity matters. For images, audio, archives, small video, and PDF page operations, use the separate @hushvert/engine package instead.

Use cases

  • Convert office documents to PDF
  • Convert PDFs to DOCX files
  • Transcode supported video files to MP4
  • Check conversion availability before submitting a job
  • Review account usage before a batch

Key features

  • Hosted office-to-PDF conversion
  • PDF-to-Word conversion
  • Document format interchange
  • Asynchronous conversion polling
  • Supported-format discovery
  • Usage and credit reporting

Tools4

What Hushvert MCP lets your agent do. Expand a tool for its parameters.

Verified live~875 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · @hushvert/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads153Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Tools exposed4Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Hushvert MCP works

What hushvert/mcp MCP server does

The hushvert/mcp MCP server gives an MCP host four tools for file conversion and account checks. It connects to the hushvert hosted API rather than performing every conversion on the local machine. The primary workflow reads a source file, sends it for a supported conversion, saves the returned file locally, and reports its output path and job details.

Supported server-side use cases include office files such as DOCX, PPTX, XLSX, DOC, PPT, XLS, ODT, ODS, ODP, RTF, and HTML to PDF; PDF to DOCX; document interchange involving formats such as Markdown, HTML, EPUB, LaTeX, RST, and DOCX; and selected video conversions, including MOV, MKV, AVI, WEBM, and MP4 operations. Use list_formats for the live set of supported pairs.

How it works

convert_file accepts an input path and target format. The source format can be supplied explicitly or inferred from the filename extension. An optional output path controls where the result is saved; otherwise, the result is written beside the source. A conversion can wait for a configured period, after which the tool may return a job ID instead of a completed file.

For unfinished jobs, convert_poll takes the job ID and an output path, then completes the local write when processing finishes. This is primarily relevant to longer-running conversions such as large video files. An idempotency key can make a retry reuse the same job rather than charge for another conversion.

Setup and configuration

Install the npm package through an MCP host using npx -y @hushvert/mcp. A hushvert developer API key is required in HUSHVERT_API_KEY. Claude Code can register the server with claude mcp add; other hosts can use an MCP configuration containing the npx command and the environment variable. Keep the key outside committed configuration files.

Optional variables include HUSHVERT_API_BASE for an alternate API endpoint, HUSHVERT_DEFAULT_WAIT_SECONDS for the default wait limit, HUSHVERT_MAX_JOBS_PER_SESSION to cap conversions in one server run, and HUSHVERT_ALLOWED_DIR to restrict file reads and writes to one directory.

Tools and capabilities

  • convert_file: Uploads a supported local file, runs the hosted conversion, writes the result, and returns status and path information.
  • convert_poll: Resumes a conversion that is still processing.
  • list_formats: Displays the hosted API’s currently supported conversion pairs.
  • check_usage: Reports free monthly conversions, credit balance, and the current billing window.

Limitations and notes

The hosted API processes files for server-only conversions, and usage is billed against the hushvert account after any free monthly allowance. Call check_usage before a large batch when cost visibility matters. The API key is read from the environment and is not returned in tool results or errors.

This server refuses conversions intended for the local @hushvert/engine package, including images, HEIC files, archives, audio, small video, and PDF page operations. LibreOffice is described as a reasonable local alternative for office-to-PDF when installed. Pandoc is not an equivalent replacement when preserving Word document styling and layout is required.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Hushvert MCP

hushvert/mcp is an MCP server that connects AI coding agents to hushvert.com’s hosted file-conversion API. Its main tools are convert_file, convert_poll, list_formats, and check_usage. It handles supported office, document, PDF, and video conversions, writes results locally, and reports usage and billing details.

Install it through an MCP host with npx -y @hushvert/mcp and provide HUSHVERT_API_KEY. Claude Code supports the claude mcp add command, while Cursor, Cline, Zed, and other MCP hosts can use a configuration with the npx command and environment variable.

It supports hosted office-to-PDF, PDF-to-DOCX, document interchange, and selected video conversions. Use list_formats for the current conversion pairs. Images, audio, archives, small video, and PDF page operations are directed to @hushvert/engine instead.

Yes, hosted conversions are billed against the hushvert account after the free monthly allowance. The check_usage tool reports remaining free conversions, credit balance, and the current billing window before a batch is run.

Yes, convert_poll resumes a conversion when convert_file returns a processing job ID. Pass the job ID and an output path to finish writing the result, which is useful for jobs that exceed the configured wait period.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHushvert MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hushvert-mcp?style=directory)](https://allmcps.com/mcp/hushvert-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/hushvert-mcp"><img src="https://allmcps.com/api/badge/hushvert-mcp?style=directory" alt="Hushvert MCP on AllMCPs" /></a>