How to connect Riverside to Claude Code, ChatGPT and any AI agent

Name: Riverside MCP Server and API by Cotlet
Author: cotlet

Yes, Claude, ChatGPT and other AI agents can work in your Riverside account. Riverside has official apps in ChatGPT and Claude for searching, editing, clipping and publishing videos. Cotlet.dev connects your own signed-in Riverside account to any AI agent, so you can ask in plain words and the AI creates studios and schedules recording sessions for you.

What you can ask

Create a studio called "Founders Talk" and schedule a recording with Maria Lopez on Thursday at 10 am.

Schedule next week's episode for Tuesday at 3 pm and send the guest invite to james@brightlane.co.

Set up a new studio for our team podcast and book a session every Monday at 9 am for the next 4 weeks.

Move Friday's 2 pm session with Dr. Patel to Monday at 11 am and let her know.

List all sessions scheduled this month across my studios, with guest names and times.

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

Claude Code

bash

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.

Cursor

Copy .cursor/mcp.json from this repo into your project:

json

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Riverside tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

json

{"mcpServers":{"riverside":{"command":"uvx","args":["riverside-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

Or with Docker:

bash

docker build -t riverside-mcp .
docker run -i --rm -e COTLET_API_KEY riverside-mcp

Tools: riverside_guide, riverside_status, riverside_open, riverside_read, riverside_click, riverside_type, riverside_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, nothing else to install. From PyPI:

bash

pip install riverside-mcp        # or run it once: uvx riverside-mcp connect
riverside-mcp connect

Or straight from this repo:

bash

export COTLET_API_KEY="your-key"
python3 riverside_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 riverside_agent.py status    # is Riverside ready in your Cotlet.dev account
python3 riverside_agent.py guide     # Riverside screens and sign-in link
python3 riverside_agent.py read      # open Riverside, read the page, close the browser
python3 riverside_agent.py tools     # list Cotlet.dev tools
python3 riverside_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Riverside users

Does Riverside have an API?

Riverside has a Business API for select Business accounts only, with a key from your customer success manager, and it mostly gets or deletes recordings and lists scheduled events (checked 11 Oct 2026). Its official MCP server (beta, Grow, Webinar and Business plans) searches, edits and posts clips, but cannot schedule sessions or invite guests. Cotlet.dev works in your own signed-in Riverside account, so your AI agent can create studios and schedule recordings with no API key and no code.

How do I connect Riverside to ChatGPT?

Riverside has an official app in the ChatGPT directory for editing and publishing. To also create studios and schedule sessions, add Cotlet.dev as an app in ChatGPT (Settings → Apps, connector URL https://cotlet.dev/mcp/v1), sign in to Riverside once in your Cotlet.dev Cloud Browser, and ask ChatGPT in plain words. No code and no Riverside API key.

Is there a way to use Claude with Riverside?

Yes. Claude lists an Anthropic verified Riverside connector for editing, clipping and publishing. With Cotlet.dev, run the one-line claude mcp add command above in Claude Code, or add https://cotlet.dev/mcp/v1 as a custom connector in the Claude app. Claude then works in your own Riverside account.

Is there a Riverside MCP server?

Riverside has official integrations listed in ChatGPT and Claude. Cotlet.dev is a hosted MCP server that works in your Riverside account for you, 24/7, with Claude, ChatGPT, Cursor, Codex, n8n, Make and Zapier.