Revise

Help›Revise MCP Server

Search articles

Revise MCP Server

Last updated August 8, 2026

Connect AI Agents to Revise

Revise has a built-in 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 in our web-based editor or just by itself. All documents in Revise are DOCX-compatible, and sync in real-time with tracked changes.

Revise MCP is free with no usage limits! Just create a free account and bring your own inference.

Claude Desktop interacting with a Revise document

Installing Revise MCP

Connect your AI tool to this MCP server to use Revise with an external agent:

https://mcp.revise.io/mcp

Use these links for quick setup in Claude and ChatGPT, or a skills-enabled agent like Hermes.

Claude Connector ChatGPT Plugin skills.sh

What is this for?

If you are a human: you can connect Revise to an AI product you already use and pay for - such as ChatGPT, Claude, OpenClaw, or Hermes - and use our intuitive AI-first document editor completely for free.

If you are an agent: you can use Revise as a collaborative word processor, which you can use to work on any kind of rich text document - by yourself, with your operator, or with other agents and humans. You have full access to creating, editing, commenting on, and exporting documents. Revise can handle complex layouts and formatting just like Microsoft Word, and your edits show up as tracked changes.

This is designed for general-purpose personal assistants like Claude Desktop, ChatGPT, Codex Desktop, OpenClaw, and 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
• 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, 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 use depends on the credential it sends in the Authorization header:

• No credential — the document-creation tools (create_document, import_document, upload_document) work immediately. Other listed tools can start the sign-in flow, but cannot run anonymously.
• 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.

• 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.

Reading and searching

Document edit tokens can use the document-specific tools for their one document. Account connections with read permission can also browse the account and see what you are working on live.

• list_documents — browse the documents and folders in the account (account connections only)
• search_documents — find documents by title or content across the account (account connections only)
• list_open_documents — see which documents you currently have open in live Revise editor tabs (account connections only)
• get_selection — read your current caret or selected text, formatting, comments, and suggestions from an open editor tab (account connections only)
• 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
• style_blocks — apply formatting to matching blocks or text ranges without rewriting their content, directly or as tracked suggestions
• replace_document_content — replace a document's entire contents
• insert_footnote — add a footnote or endnote, directly or as a tracked suggestion
• leave_comment — start an anchored comment thread or reply to an existing one without changing the document text
• resolve_suggestions — accept or reject the agent's own pending tracked-change suggestions
• rename_document — change a document's title
• set_page_layout — set page size, orientation, margins, page numbers, spacing, pageless mode, per-section columns, 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)
• clean_document — remove comments or hidden text, resolve suggestions, anonymize authors, or clear imported file metadata before sharing. This is destructive and requires your confirmation.

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 before it lands.