Connect to Riverside MCP

« To Riverside integrations: Overview

Give your AI agent direct access to your Riverside content and let it search your transcripts, cut edits, and schedule posts for you, all from your chat.

Riverside's MCP is the bridge between your Riverside content and your AI of choice, whether that's Claude, ChatGPT, Cursor or Codex. It finds anything across your archives, edits content based on your descriptions, cuts the clips you want and publishes to your social platforms, all without leaving the chat.

How to connect

• Connect to Claude.ai

  1. Open the Customize tab in the left sidebar, then click Connectors.
  2. Click the + next to Connectors, then Add custom connector.
  3. Enter Name: Riverside.
  4. Enter URL: https://mcp.riverside.com/mcp.
  5. Click Add.
     You'll see a "not verified" warning. That's expected for custom connectors, no action is needed.
  6. Click Connect.
  7. Sign in to Riverside.

  8. When prompted, click "Open Claude".
     Your agent is ready to use your Riverside content.

     * On the Free Claude plan, you can add only one custom connector.

• Connect to Claude Code

  1. In your terminal, run: claude mcp add --transport http --scope user riverside https://mcp.riverside.com/mcp.
  2. Open Claude Code and run /mcp to sign in.
     The --scope user part makes Riverside available in every folder, not just the one where the command ran.

• Connect to ChatGPT

  You must be in Developer mode to connect.

  1. Click your profile in the bottom left corner and open Settings.
  2. Select Apps.
  3. Under Advanced settings, toggle Developer mode ON.
  4. Back in Apps, click Create.
  5. Enter Name: Riverside.
  6. Enter URL: https://mcp.riverside.com/mcp
  7. Select authentication: OAuth.
  8. Click Scan Tools and complete the sign-in to Riverside.
  9. Wait for the scan to finish, then click Create.

  10. Riverside now appears under Settings > Apps. 
      Mention Riverside in a prompt or pick it from the + menu in a chat.

      * On the Free ChatGPT plan, you can only read from Riverside MCP.

      * On ChatGPT Enterprise, Business, Team, or Edu accounts, your account admin needs to connect

• Connect to Codex

  This one setup covers Codex CLI, the Codex IDE extension, and the ChatGPT desktop app.

  1. Add the server: codex mcp add riverside --url https://mcp.riverside.com/mcp (alternative: add a [mcp_servers.riverside] section with url = "https://mcp.riverside.com/mcp" to ~/.codex/config.toml).
  2. Sign in: codex mcp login riverside.
  3. In a Codex session, run /mcp to confirm Riverside is connected and its tools are listed.
     Don't use an npx/mcp-remote bridge. Codex handles remote HTTP and OAuth itself.

• Connect to Cursor

  1. Paste the following URL into your browser: 

     https://cursor.com/install-mcp?name=riverside&config=eyJ1cmwiOiJodHRwczovL21jcC5yaXZlcnNpZGUuY29tL21jcCJ9

  Or

  The manual alternative:

  1. Add to ~/.cursor/mcp.json:

     {
       "mcpServers": {
         "riverside": {
           "url": "https://mcp.riverside.com/mcp"
         }
       }
     }

  2. Navigate to Cursor Settings.
  3. Click MCP.
     Riverside appears in the server list. 
  4. Click the Riverside MCP to sign in.
  5. Cursor opens Riverside's login in your browser.
  6. Click approve.
     Your Riverside MCP is now ready to use.

To publish or schedule posts through your agent, connect the social platform (YouTube, YouTube Shorts, Instagram, TikTok, LinkedIn, X, Facebook) in the Riverside dashboard first. Platforms can only be connected on Riverside, not through your agent.

Good to know

• You'll need to authenticate separately for each AI agent you connect to Riverside.
• When your agent makes an edit, it opens a new edit rather than overwriting existing content, so your original stays intact.
• Connecting an agent doesn't change anything in your Riverside account settings.

Learn more

• Riverside integrations: Overview
• AI at Riverside: Everything you need to know