# Markovo File to Text, Word and Markdown

> Markovo File to Text, Word and Markdown is a freemium MCP server for files and documents. MCP server that converts files and public HTTPS pages to text, Word or Markdown. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, macOS, Windows, Linux
- **Website:** https://markovo.net/docs/mcp
- **Repository:** https://github.com/fisher-byte/markovo
- **MCP Registry name:** io.github.fisher-byte/markovo
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-14

## About

Conversion happens in Markovo's metered cloud service, not locally. The CLI and stdio server in the repo are thin clients, and the repo says it holds no conversion engine or billing code. Two ways to connect exist. The hosted remote server at markovo.net/mcp uses OAuth 2.1 with PKCE, so no API key is pasted anywhere, and it can only convert one explicitly supplied public HTTPS page. The local stdio package reads and writes files, but only inside a directory you set as `MARKOVO_MCP_ROOT`, and refuses file tools if it is missing.

Cost control is built in. Before queuing, the remote tool gets a server-side estimate and runs only if it is at or below your `max_credit_units` ceiling; one Credit is 1,000 units, and failed or cancelled jobs are not charged. The server never buys Credits or changes a plan. Supported URL sources include HTML, public Google Docs, Notion pages, GitHub text and discussions, Hacker News threads and downloadable YouTube videos, which are transcribed by audio at 0.5 Credits per decoded minute.

Output can be Markdown, editable Word or text, and fetching another format of the same conversion costs nothing. Private, signed and login-only pages are rejected.

## Features

- **Credit ceiling per call:** Conversion queues only when the estimate is within max_credit_units.
- **Output formats:** Markdown, docx or txt from the same conversion.
- **Scoped OAuth:** Remote scopes separate reading account data from converting a page.
- **Folder-bounded file access:** The stdio server limits reads and writes to MARKOVO_MCP_ROOT.
- **Public-page safety:** Rejects private networks and credential-bearing targets and sends no cookies.
- **Short-lived image links:** Create public result-image URLs that expire after 60 to 600 seconds.

## Good for

- Turn a PDF into Markdown for an agent to read
- Convert a public Notion page to Word
- Transcribe a YouTube video to text
- Check Credit balance and recent jobs
- Create a temporary link for a result image

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http markovo https://markovo.net/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://markovo.net/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "markovo": {
      "url": "https://markovo.net/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "markovo": {
      "type": "http",
      "url": "https://markovo.net/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "markovo": {
      "serverUrl": "https://markovo.net/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://markovo.net/mcp
```

Enter a Name (for example "Markovo File to Text, Word and Markdown"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "markovo": {
      "type": "http",
      "url": "https://markovo.net/mcp"
    }
  }
}
```

## Tools

- `markovo_capabilities`: List supported conversion capabilities and limits.
- `markovo_usage`: Inspect the workspace Credit balance.
- `markovo_jobs`: List recent jobs owned by the workspace.
- `markovo_job_status`: Inspect one owned job.
- `markovo_convert_url`: Convert one public HTTPS source under a credit ceiling.
- `markovo_job_assets`: List verified images in a completed result.
- `markovo_create_asset_link`: Create an expiring public image URL.
- `markovo_revoke_asset_link`: Revoke an image URL early.
- `markovo_billing_help`: Return usage and the billing page link.

## FAQ

### Can the remote server read my local files?

No. It has no local file tool; use the stdio package or REST upload for local files.

### How is spending limited?

Each conversion needs an explicit credit ceiling and is skipped if the estimate exceeds it.

### Are failed jobs charged?

No. Failed, timed-out or system-cancelled jobs are not charged.

### Which sources are not supported?

Private, signed, login-only and browser-only pages, generic binary files and Tencent Docs.

### Do I need an API key?

The stdio server needs MARKOVO_API_KEY; the remote server signs in with OAuth instead.

### Is Markovo File to Text, Word and Markdown free?

Markovo File to Text, Word and Markdown has a free plan, with paid plans for more usage or features.

### How do I add Markovo File to Text, Word and Markdown to Claude Code?

Run this command in your terminal: claude mcp add --transport http markovo https://markovo.net/mcp

### What are the best alternatives to Markovo File to Text, Word and Markdown?

The closest alternatives to Markovo File to Text, Word and Markdown are Markdown Logic Express, markitai, LoveMarkdown, flatmark and RenderMark.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Markdown Logic Express](https://ai-powered.com/mcp/markdown-logic-express): Markdown Logic Express is a free MCP server for files and documents.
- [markitai](https://ai-powered.com/mcp/markitai): markitai is an open-source MCP server for files and documents.
- [LoveMarkdown](https://ai-powered.com/mcp/lovemarkdown): LoveMarkdown is an open-source MCP server for files and documents.
- [flatmark](https://ai-powered.com/mcp/flatmark): flatmark is a freemium MCP server for files and documents.
- [RenderMark](https://ai-powered.com/mcp/rendermark): RenderMark is an MCP server for files and documents.
- [PDF to Markdown](https://ai-powered.com/mcp/pdf-to-markdown-2): PDF to Markdown is a freemium MCP server for files and documents.
- [PDF to Markdown](https://ai-powered.com/mcp/pdf-to-markdown): PDF to Markdown is a freemium MCP server for files and documents.
- [Markdown to HTML Got Simplified](https://ai-powered.com/mcp/markdown-to-html-got-simplified): Markdown to HTML Got Simplified is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/markovo-file-to-text-word-and-markdown
