# Office files for your AI agents, over MCP

> Give Claude Code, Codex, Cursor or any MCP client the tools to open, read, create and edit Word, Excel and PowerPoint files, PDFs, Markdown and pictures, and watch each change in the MCP Docs app.

Coding agents are good at text and bad at Office files. MCP Docs gives them real tools for Word, Excel and PowerPoint files, PDFs, Markdown and pictures, through the Model Context Protocol (MCP), and shows you each file in the app as the agent changes it.

![MCP Docs open on an Excel spreadsheet of recent YC companies](https://mcpdocs.freeflow.im/marketing/promo-poster.webp)

## Connect your agent

Install the desktop app and add it to Claude Code and Codex in one step:

```sh
npx @freeflow-im/mcp-docs
```

The installer asks which agents to add it to and prints the server's address for any other MCP client, such as Cursor. The app is the MCP server: it runs on your machine, on the folder open in its window, and you allow each agent that connects.

For the web version (beta), connect any client that supports remote MCP servers with OAuth:

```sh
claude mcp add --transport http universal-docs https://mcpdocs.freeflow.im/mcp/v2
```

## What your agent can do

- **Spreadsheets:** read and write ranges, formulas included, sort, filter, format, freeze panes, manage tabs, and add and edit charts.
- **Presentations:** read a deck, add, change, move and delete slides, edit elements, set the theme, and look at a picture of a slide to check its own work.
- **Documents and Markdown:** read them as numbered blocks, then insert, replace and delete blocks, replace text and format it.
- **PDFs:** read the text of any PDF, and convert it to a Markdown file, scanned pages included.
- **Pictures:** look at a picture, crop, resize and adjust it, add text and layers, and remove its background.
- **Files:** list, open, create, rename, move and import files and folders, and open any file by its path.

## Watch it work

Every file the agent opens or creates is shown in the app, and its edits to the open file happen in the window: you see each change as it is made, and you can undo it like your own. Changes that delete data ask you first. When you have the file open and the agent changes it on disk some other way, the app reloads it.

## The built-in assistant

Every file also has an assistant beside it in the app. It uses the same tools, on Claude or on your own Anthropic, OpenAI or OpenRouter key, and in the desktop app it can run on the Claude Code you already have, with no key at all.

## Frequently asked questions

### Which agents work with MCP Docs?

Any MCP client: Claude Code and Codex (the installer adds it to both), Cursor, Claude Desktop and others. Agents that connect to the desktop app sign in with OAuth, and you allow each one in the app.

### Do my files leave my computer?

Not with the desktop app. Its MCP server runs on your machine and works on the files in your folder. Only what you send to an AI model goes to that model's provider.

### Does it keep my files in their formats?

Yes. In the desktop app a Word file stays a `.docx`, an Excel file an `.xlsx` and a PowerPoint file a `.pptx`, so they still open everywhere else.

### Is it free?

Yes. MCP Docs is free and open source, for Macs with Apple silicon and 64-bit Windows, and in beta on the web.

## Get MCP Docs

- Download the desktop app for macOS or Windows: https://github.com/freeflow-im/mcp-docs/releases/latest
- Install it and add it to Claude Code and Codex: `npx @freeflow-im/mcp-docs`
- The web version (beta): https://mcpdocs.freeflow.im/register
- How an agent connects to MCP Docs: https://mcpdocs.freeflow.im/llms.txt

## Other features

- [Edit PowerPoint presentations with your AI agent](https://mcpdocs.freeflow.im/features/presentations.md): Open, edit and save PowerPoint (.pptx) presentations with an AI assistant beside them, or let Claude Code, Codex or any MCP client build and edit the slides while you watch.
- [Excel spreadsheets your AI agent can work in](https://mcpdocs.freeflow.im/features/spreadsheets.md): Edit Excel (.xlsx) and CSV files with formulas, filters, charts and formatting, and let an AI assistant, Claude Code, Codex or any MCP client sort, clean up and fill in the data.
- [Word documents you write with your AI agent](https://mcpdocs.freeflow.im/features/documents.md): Write and edit Word (.docx) documents with headings, pictures and video, and let the built-in AI assistant, Claude Code, Codex or any MCP client draft and edit them with you.
- [A Markdown editor built for working with agents](https://mcpdocs.freeflow.im/features/markdown.md): A GitHub-flavored Markdown editor with a live preview and Mermaid diagrams, where the AI assistant, Claude Code, Codex or any MCP client edits the same files you do.
- [PDFs your AI agents can read](https://mcpdocs.freeflow.im/features/pdfs.md): Read and sign PDFs, and turn any PDF, scanned pages included, into Markdown that Claude Code, Codex and other AI agents can read and edit, with the free MCP Docs app.
- [An image editor you can ask](https://mcpdocs.freeflow.im/features/images.md): Crop, resize, adjust colors, add text and shapes and stack layers on your pictures, or ask the AI assistant to do it, background removal included, in the free MCP Docs app.
