Connect your agent

Through MCP, an AI agent can read and edit the document open in Ream. While a document is open, the local MCP server is available at http://127.0.0.1:41100/mcp.

Before you start

1. Download and install Ream.
2. Launch the app and open a file. The MCP server runs while a file is open in Ream.

Claude Code

Open your terminal and add the Ream marketplace:

claude plugin marketplace add ream-design/agent-plugins

Install the plugin:

claude plugin install ream-desktop@ream

Start Claude Code:

claude

If Claude Code was already running, restart it to load the plugin.

Cursor

The Ream plugin isn't in the Cursor Marketplace yet, so add the server through settings. Open Cursor Settings → MCP → Add new MCP server, or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ream": {
      "url": "http://127.0.0.1:41100/mcp"
    }
  }
}

Codex

Add the Ream marketplace:

codex plugin marketplace add ream-design/agent-plugins

Install the plugin:

codex plugin install ream-desktop@ream

Start Codex:

codex

Other agents

Ream works with any agent that supports MCP over HTTP. Point it at the server address:

http://127.0.0.1:41100/mcp

Check it works

Send your agent this request:

Create a frame with a red rectangle in Ream.

A frame with a red rectangle should appear on the canvas.

If it doesn't work

• Connection refused. Launch Ream and open a document.
• No Ream tools after installation. Restart your agent session.
• Free-plan call limit reached. The tool response says when calls become available again.