[Help](https://revise.io/help)›Revise MCP Server

# Revise MCP Server

## Connect AI Agents to Revise (in beta)

Revise has a [built-in AI Agent](https://revise.io/help/ai-agent), but it also exposes an MCP server for external agents. This means any agent with MCP support can use Revise to write, edit, read, and share documents - collaboratively with its operator or completely by itself. All document changes by people and agents sync in real-time!

```
https://mcp.revise.io/mcp
```

If you are a human, this means you can connect Revise to an AI product you already use and pay for and use it to help you with any kind of writing or document work, completely for free.

If you are an agent, this means you have access to a word processor which you can collaborate in with your operator.

![Claude Desktop interacting with a Revise document](https://revise.io/help/v2/mcp-light.png)![Claude Desktop interacting with a Revise document](https://revise.io/help/v2/mcp-dark.png)Claude Desktop interacting with a Revise document

This is designed for general-purpose personal assistants like Claude Desktop, ChatGPT, Codex Desktop, OpenClaw, anad Hermes.

### What agents can do

- Create documents from markdown and read or search existing ones
- Make targeted edits — directly, or as tracked changes you review and accept or reject in the editor, just like [suggesting mode](https://revise.io/help/suggesting-mode)
- Import a Word, Markdown, HTML, or text file into a new document
- Export documents to Markdown, HTML, text, Word, or PDF
- Invite specific people to a document as collaborators

Every agent edit syncs in real time and is recorded in your [revision history](https://revise.io/help/revision-history), so you can always see exactly what an agent changed. The full tool-by-tool reference is below.

### Try it with no account

An agent does not need a Revise account to get started. Ask it to draft a document, import one from a link, or upload a file you already have, and it gets back a link it can hand you — you open the link to see the document and, in the same step, create a free account to keep it. From that moment you and the agent are working on the same live document. No other major word processor lets an assistant start a document with you this way.

### Tips

- Agents only access the account that issued the credential
- Ask agents to use suggest mode when you want to review every change before it lands
- Agents can share a document with specific people you name, but cannot make a document publicly accessible — that stays a decision only you can make in the app
- Deleted documents go to the trash and can be restored

## Tools Reference

These are the tools the Revise MCP server makes available to a connected agent. Which tools an agent can see depends on the credential it sends in the `Authorization` header:

- No credential — the document-creation tools (`create_document`, `import_document`, `upload_document`) plus `convert_document`. Enough to start a document with someone who has no account yet.
- A document edit token (`rvse_doc_…`) — returned by the creation tools above. It unlocks the read and editing tools for that one document, plus `request_account_access` to level up.
- An account credential (`rvse_pat_…` API key or an approved OAuth connector) — the full set across the account, scoped to the read, write, and sharing permissions granted.

### No account required

Available to any agent, with no credentials. The three document-creation tools are the starting point for collaborating on a brand-new document: each returns a link to give you (you open it to view the document and create a free account in one step) plus an edit token the agent reuses to keep editing. `convert_document` is different — it creates no document, just transforms a file and hands back a temporary download link.

- `create_document` — create a document from markdown
- `import_document` — create a document from a Word, Markdown, HTML, or text file at a public URL the server fetches (for a local file, use `upload_document`)
- `upload_document` — create a document from a local file the agent streams up, without putting its bytes in the conversation. The easiest way for an assistant to turn a file you already have into a Revise document before you have an account.
- `convert_document` — convert a file from one format to another (for example, Word to PDF). The agent either points at a public URL the server fetches, or streams a local file up, and gets back a temporary download link to the converted file — nothing is sent through the conversation. Any readable format (Word, Markdown, HTML, text) can be converted to any writable format (Markdown, HTML, text, Word, PDF).

### Reading and searching

Account connections with read permission.

- `list_documents` — browse the documents and folders in the account
- `search_documents` — find documents by title or content
- `read_document` — read a document as markdown, text, or HTML
- `search_within_document` — find matches inside one document
- `get_document_outline` — get a document's heading structure
- `get_document_info` — metadata like title, size, and dates
- `get_recent_changes` — see what changed recently, including edits made by people or other agents
- `export_document` — export to Markdown, text, HTML, Word, or PDF. Markdown comes back inline; every other format is hosted at a temporary download link (it expires after about a day)

### Writing and editing

Account connections with write permission.

- `create_document` — create a new document in the account
- `edit_document` — make targeted edits, either applied directly or left as suggestions for you to accept or reject
- `replace_document_content` — replace a document's entire contents
- `rename_document` — change a document's title
- `set_page_layout` — set page size, orientation, margins, page numbers, spacing, pageless mode, or the APA-7 preset
- `import_document` / `upload_document` — import from a URL or stream a local file into a new document
- `delete_document` — move a document to the trash (restorable)

### Sharing

Account connections with sharing permission.

- `invite_collaborator` — invite a specific person to a document as a viewer or editor. Agents cannot make a document public.

### Leveling up from a document token

Available only to a document edit token, after the document has been claimed by its owner.

- `request_account_access` — ask the document's owner to upgrade your single-document token to account-wide access. Returns an approval link to give the user; if they approve, the same token you are already using gains the granted scopes and the rest of the tools above appear on your next request.

Tip: Ask your agent to edit in suggest mode and every change arrives as a tracked proposal you can review in [review mode](https://revise.io/help/ai-reviewing-changes) before it lands.