# MR Office

> MR Office is a free MCP server for files and documents. MCP server that lets AI assistants create and co-edit documents, sheets and PDFs in MR. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI, Self-hosted, macOS, Windows, Linux, VS Code
- **Website:** https://mroffice.ai/developers/mcp
- **Repository:** https://github.com/xinatian/mroffice/tree/HEAD/apps/mcp
- **MCP Registry name:** ai.mroffice/office
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-20

## About

The README describes an assistant that writes a document or spreadsheet, opens it in an editor, lets the person change it by hand, and then reads those edits back before continuing. Documents can be created from Markdown or CSV, and existing Markdown, HTML, text, CSV, TSV and PDF files can be opened from text, base64 or an https link.

In clients that support MCP Apps, the editor appears inline in the chat and autosaves. In other clients the tools return a browser link to the same editor along with a picture of the page. Edits can be exported as .docx, .xlsx, .pptx, Markdown, HTML, CSV or PDF.

It runs either as a hosted server at mcp.mroffice.ai, which signs the user in with OAuth, or locally via npx on the user's own machine, where documents stay in a local folder. Word, Excel and PowerPoint conversion goes through MR Office's service under the user's own account, and according to the README those files are not stored after conversion.

## Features

- **Create from Markdown or CSV:** New documents are made from Markdown and new spreadsheets from CSV, then opened in the editor.
- **Inline co-editing:** In apps that support MCP Apps, the editor shows inside the conversation and saves automatically.
- **Read back human edits:** The assistant can fetch the person's current content, including manual changes, before editing again.
- **Page rendering:** Any page can be rendered to a PNG as the editor draws it.
- **Multi-format export:** Documents can be exported to docx, xlsx, pptx, Markdown, HTML, CSV or PDF.
- **Local or hosted operation:** Run it locally over stdio with npx, or connect to the hosted streamable-HTTP endpoint.

## Good for

- Have an assistant draft a report that the user then refines in the editor
- Generate a spreadsheet from CSV data and review it inline in a chat
- Open an existing Word or PDF file and make changes through an AI assistant
- Export an AI-drafted document to docx or PDF for sharing

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http office https://mcp.mroffice.ai/mcp
```

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

```sh
https://mcp.mroffice.ai/mcp
```

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

```json
{
  "mcpServers": {
    "office": {
      "url": "https://mcp.mroffice.ai/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "office": {
      "type": "http",
      "url": "https://mcp.mroffice.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "office": {
      "serverUrl": "https://mcp.mroffice.ai/mcp"
    }
  }
}
```

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

```sh
https://mcp.mroffice.ai/mcp
```

Enter a Name (for example "MR Office"), 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": {
    "office": {
      "type": "http",
      "url": "https://mcp.mroffice.ai/mcp"
    }
  }
}
```

## Tools

- `create_document`: New document (Markdown) or spreadsheet (CSV), opened in the editor
- `open_document`: Open a file given as text, base64 or an https URL
- `update_document`: Replace a document's content as a new revision
- `get_document`: The current content, with the person's edits
- `render_page`: A PNG of one page as the editor draws it
- `export_document`: The document as a file, with a download link
- `list_documents`: The documents created or opened with this server

## FAQ

### Is MR Office free to use?

The pricing page says the MCP server is free and open source. Word, Excel and PowerPoint conversion uses the signed-in user's MR Office plan and quota, and a free account is enough.

### Where are documents stored?

When run locally, documents are saved in a folder on the user's machine, and the editor page is served on 127.0.0.1. The README says only the editor's scripts, styles and fonts load from demo.mroffice.ai.

### Do I need to install anything to use MR Office?

No. The hosted server at https://mcp.mroffice.ai/mcp needs no installation; you sign in to MR Office in the browser on first use. The local option runs with npx -y mroffice-mcp and needs Node.js 22 or newer.

### Which MCP clients does MR Office work with?

The README says any MCP client that starts local stdio servers can run it, and clients that connect to remote servers can use the hosted endpoint. The product page lists Claude, ChatGPT, Cursor and VS Code as target apps.

### How do I add MR Office to Claude Code?

Run this command in your terminal: claude mcp add --transport http office https://mcp.mroffice.ai/mcp

### What are the best alternatives to MR Office?

The closest alternatives to MR Office are Markdown Formatter, Document Converter, RenderMark, Google Docs MCP and Asterism MCP.

## Where this comes from

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

## Alternatives

- [Markdown Formatter](https://ai-powered.com/mcp/markdown-formatter): Markdown Formatter is an open-source MCP server for files and documents.
- [Document Converter](https://ai-powered.com/mcp/document-converter): Document Converter is an open-source MCP server for files and documents.
- [RenderMark](https://ai-powered.com/mcp/rendermark): RenderMark is an MCP server for files and documents.
- [Google Docs MCP](https://ai-powered.com/mcp/google-docs-mcp-2): Google Docs MCP is an open-source MCP server for files and documents.
- [Asterism MCP](https://ai-powered.com/mcp/asterism-mcp): Asterism MCP is a freemium MCP server for files and documents.
- [MCP Office Word](https://ai-powered.com/mcp/mcp-office-word): MCP Office Word is an open-source MCP server for files and documents.
- [SumOffice — real Word and Excel for agents](https://ai-powered.com/mcp/sumoffice-real-word-and-excel-for-agents): SumOffice — real Word and Excel for agents is a freemium MCP server for files and documents.
- [aidocx](https://ai-powered.com/mcp/aidocx): aidocx is an MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/mr-office
