> ## 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 Server

> Connect Reap to MCP-compatible AI tools so your agent can create clips, captions, reframes, dubbing projects, and published posts from your 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.

## What Is Reap MCP?

Reap MCP lets AI tools connect to your Reap workspace through the Model Context Protocol (MCP). After you connect it, you can ask an AI agent to create clips, add captions, reframe videos, dub videos, check project status, retrieve clip links, and publish or schedule content from Reap.

You do not need to copy an API key into your AI tool. Reap MCP uses OAuth, so you sign in to Reap and choose the workspace the agent is allowed to use.

## Before You Start

* Your Reap workspace must be on a paid plan with API access enabled.
* Your AI tool must support remote MCP servers.
* You need access to the Reap workspace you want to connect.
* For ChatGPT, custom MCP app availability depends on your OpenAI plan and workspace settings.

## Reap MCP Server URL

Use this URL when your AI tool asks for the MCP server URL:

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

## Connect Reap MCP To GPT

Use this option when you want to connect Reap MCP to ChatGPT as a custom MCP app.

### Custom Install: ChatGPT (Developer Mode)

<Steps>
  <Step title="Open ChatGPT connector settings">
    Go to [ChatGPT connector settings](https://chatgpt.com/#settings/Connectors).
  </Step>

  <Step title="Open advanced settings">
    In **Apps**, open **Advanced settings**.

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/chatgpt-mcp-app-preferences.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=bec7b9ecfdb5881e6726463f7efc3db1" alt="ChatGPT app preferences showing Advanced settings for creating an app" width="1338" height="1178" data-path="images/help-center/chatgpt-mcp-app-preferences.png" />
    </Frame>
  </Step>

  <Step title="Enable Developer Mode">
    Turn on **Developer Mode** so you can create a custom MCP app.

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/chatgpt-mcp-developer-mode.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=247e6e8ebc5ee163bc354afe2d94ad4e" alt="ChatGPT advanced settings with Developer Mode enabled" width="1344" height="1186" data-path="images/help-center/chatgpt-mcp-developer-mode.png" />
    </Frame>
  </Step>

  <Step title="Create a custom app">
    Click **Create app** or **Add custom app**, depending on the option shown in your workspace.
  </Step>

  <Step title="Add Reap MCP details">
    Use these values:

    <ul>
      <li><strong>Name:</strong> <code>Reap</code></li>
      <li><strong>MCP Server URL:</strong> <code>[https://mcp.reap.video/mcp](https://mcp.reap.video/mcp)</code></li>
      <li><strong>Authentication:</strong> <code>OAuth</code></li>
    </ul>

    The icon is optional. If you want the Reap logo to appear in ChatGPT, download this icon and upload it in the **Icon** field: [Download Reap MCP icon](/images/help-center/reap-mcp-icon.png).

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/chatgpt-mcp-new-app.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=8e4c46ccd4504f290c3e6fb77e789896" alt="New ChatGPT app form with Reap MCP server URL and OAuth authentication" width="878" height="1542" data-path="images/help-center/chatgpt-mcp-new-app.png" />
    </Frame>
  </Step>

  <Step title="Publish or enable the app">
    Publish the app for your workspace or enable it for yourself, depending on your ChatGPT plan and admin permissions.
  </Step>

  <Step title="Connect and authorize Reap">
    Click **Connect**, sign in to Reap, choose the workspace you want ChatGPT to use, and click **Authorize**.

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/chatgpt-mcp-sign-in.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=a35a8eb39d44e3875ca5d8fda60a81f7" alt="ChatGPT prompt to sign in with Reap" width="1334" height="1172" data-path="images/help-center/chatgpt-mcp-sign-in.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/chatgpt-mcp-authorize-reap.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=f9490ce2f5492a7dc0ce83808b80e475" alt="Reap authorization screen for granting ChatGPT workspace access" width="884" height="1216" data-path="images/help-center/chatgpt-mcp-authorize-reap.png" />
    </Frame>
  </Step>
</Steps>

<Note>
  If you do not see Developer Mode or custom app options in ChatGPT, check your OpenAI plan and workspace permissions. Some settings are only available to workspace admins or supported paid plans.
</Note>

## Connect Reap MCP To Claude

Use this option when you want Claude to access Reap from Claude chat.

<Steps>
  <Step title="Open Claude connector settings">
    Go to [Claude connector settings](https://claude.ai/settings/connectors).

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/claude-mcp-connectors-settings.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=5ab6dc4b4abcb209f77d1785e907b783" alt="Claude settings showing the Connectors section and Customize link" width="1888" height="1418" data-path="images/help-center/claude-mcp-connectors-settings.png" />
    </Frame>
  </Step>

  <Step title="Add a custom connector">
    Click **Add custom connector**. In some Claude workspaces, this appears under **Customize** > **Connectors**.

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/claude-mcp-add-custom-connector.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=3fd0525acd9c393ca0427f5ac47deb04" alt="Claude Customize connectors menu showing Add custom connector" width="3234" height="818" data-path="images/help-center/claude-mcp-add-custom-connector.png" />
    </Frame>
  </Step>

  <Step title="Add Reap MCP details">
    Use these values:

    <ul>
      <li><strong>Name:</strong> <code>Reap</code></li>
      <li><strong>MCP Server URL:</strong> <code>[https://mcp.reap.video/mcp](https://mcp.reap.video/mcp)</code></li>
      <li><strong>Authentication:</strong> <code>OAuth</code></li>
    </ul>

    <Frame>
      <img src="https://mintcdn.com/reap/MrAL4JmQquuYF1ao/images/help-center/claude-mcp-connector-details.png?fit=max&auto=format&n=MrAL4JmQquuYF1ao&q=85&s=26e21276529f0c99ee403360791e73bb" alt="Claude Add custom connector form with Reap MCP server URL" width="1048" height="1006" data-path="images/help-center/claude-mcp-connector-details.png" />
    </Frame>
  </Step>

  <Step title="Enable Reap in your chat">
    In Claude, enable the Reap connector for the conversation before asking Claude to use it.
  </Step>
</Steps>

## Connect Reap MCP To Claude Code

If you use Claude Code, add Reap as an HTTP MCP server from your terminal:

```bash theme={"system"}
claude mcp add --transport http reap "https://mcp.reap.video/mcp"
```

Claude Code opens the Reap OAuth sign-in flow. Sign in, choose your workspace, authorize access, and return to Claude Code.

## Connect Reap MCP To Cursor Or VS Code

For Cursor, add Reap to `.cursor/mcp.json`. For VS Code, add it to `.vscode/mcp.json`. You can also use your global MCP settings if you want Reap available across projects.

```json theme={"system"}
{
  "mcpServers": {
    "reap": {
      "url": "https://mcp.reap.video/mcp"
    }
  }
}
```

After saving the config, reload your editor if needed. The first time you use a Reap tool, your agent should start the Reap OAuth flow.

## Authorize Your Reap Workspace

No matter which agent you connect, the authorization flow works the same way:

<Steps>
  <Step title="Sign in to Reap">
    Log in to the Reap account that has access to the workspace you want to connect.
  </Step>

  <Step title="Choose the workspace">
    Select the Reap workspace your agent is allowed to use.
  </Step>

  <Step title="Authorize access">
    Click **Authorize**. The agent only gets access to the workspace you selected.
  </Step>

  <Step title="Return to your AI tool">
    Close the browser tab after authentication succeeds, then return to your agent and continue your workflow.
  </Step>
</Steps>

## Confirm The Connection Works

After connecting, try asking your agent:

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

You can also try:

```text theme={"system"}
Show me my recent Reap projects.
```

If the agent can list Reap tools or access your selected workspace, the connection is working.

## What You Can Ask Your Agent To Do

Once connected, your agent can help with workflows like:

* Generate AI clips from a video upload or supported source URL.
* Add captions to a video.
* Reframe a video into portrait or square format.
* Dub a video into another language.
* Transcribe a video.
* Check project status and retrieve generated clip links.
* Publish or schedule clips to connected social platforms.

<Warning>
  Publishing or scheduling content can affect public social accounts. Your agent should ask for confirmation before posting, scheduling, or changing published content.
</Warning>

## Things To Note

* Reap MCP uses OAuth, so you do not need to paste a Reap API key into your AI tool.
* Your agent only has access to the Reap workspace you authorize.
* You can revoke access later from your Reap dashboard.
* If your AI tool does not show Reap tools after connecting, restart the tool or reconnect the MCP server.
* If publishing tools fail, make sure your social accounts are connected in Reap.

## Troubleshooting

* Make sure your Reap plan includes API access.
* Confirm you authorized the correct workspace during OAuth.
* If the browser does not open automatically, copy the authorization URL from your agent and open it manually.
* If tools do not appear, reconnect the MCP server or restart your AI tool.
* If publishing fails, check that your social accounts are connected in Reap.

## Learn More

* [MCP API Reference](/api-reference/mcp)
* [Reap Agent Skills](/api-reference/agent-skills)
* [Connect Social Media Accounts](/help-center/how-to-connect-social-media-accounts)
* [Reap Dashboard](https://app.reap.video)