> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reap.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Reap MCP To Cursor

> Add Reap to Cursor with a small mcp.json entry, sign in with OAuth, and let Cursor clip, caption, reframe, dub, and publish from your Reap workspace.

> **For AI agents:** a documentation index is at [/llms.txt](/llms.txt). Every page is also available as markdown, just append `.md` to the URL.

## Overview

Cursor reads MCP servers from an `mcp.json` file. You add Reap with a short entry, sign in through OAuth, and pick the workspace Cursor is allowed to use.

## Before You Start

* Your Reap workspace must be on a paid plan with API access enabled.
* Install Cursor and sign in to it.
* You need access to the Reap workspace you want to connect.

## Reap MCP Server URL

```text theme={"system"}
https://mcp.reap.video/mcp
```

## Add Reap To Cursor

<Steps>
  <Step title="Choose project or global">
    For a single project, create `.cursor/mcp.json` in the project root. To make Reap available everywhere, create `~/.cursor/mcp.json` instead.
  </Step>

  <Step title="Add the Reap server">
    ```json theme={"system"}
    {
      "mcpServers": {
        "reap": {
          "url": "https://mcp.reap.video/mcp"
        }
      }
    }
    ```

    Remote servers use `url`. There is no `command` to run and nothing to install locally.
  </Step>

  <Step title="Reload Cursor">
    Save the file. If Reap does not appear right away, reload the window or restart Cursor.
  </Step>

  <Step title="Sign in to Reap">
    Open **Cursor Settings** > **Customize**, where your MCP servers are listed. Find **reap** and click to connect or log in. Cursor also starts the sign-in flow automatically the first time it uses a Reap tool.
  </Step>

  <Step title="Choose a workspace and authorize">
    Sign in to Reap, select the workspace Cursor is allowed to use, and click **Authorize**. Close the tab when you see **Authentication successful**, then return to Cursor.
  </Step>
</Steps>

<Tip>
  For a faster route, paste this into Cursor's chat: *"Add reap to my global MCP servers using `https://mcp.reap.video/mcp` and connect."* Cursor writes the config and starts the sign-in for you.
</Tip>

## Confirm The Connection Works

In **Cursor Settings** > **Customize**, **reap** should show as connected with its tools listed. You can also ask in chat:

```text theme={"system"}
What Reap tools do you have access to?
```

## Use Reap From Cursor

```text theme={"system"}
Clip the best moments from this video and keep them under 60 seconds: <url>
```

```text theme={"system"}
Add captions to this video and translate them into Spanish.
```

## Troubleshooting

* **Reap not listed?** Check that the JSON is valid and uses the `mcpServers` key, then reload the Cursor window.
* **Listed but no tools?** Click **reap** under **Customize** and complete the OAuth sign-in.
* **Works in one project only?** A `.cursor/mcp.json` in a project root applies to that project. Move the entry to `~/.cursor/mcp.json` to use Reap everywhere.
* **Wrong workspace?** Disconnect Reap in settings, reconnect, and pick the correct workspace on the Reap authorization screen.

## Learn More

* [Connect Reap MCP Server](/help-center/connect-reap-mcp-server)
* [Connect Reap MCP To VS Code](/help-center/connect-reap-mcp-to-vs-code)
* [Reap MCP Guide](/help-center/reap-mcp-guide)
* [MCP API Reference](/api-reference/mcp)
* [Reap Dashboard](https://app.reap.video)