How to connect Frame.io V4 to Claude

Connect Claude Web, Desktop and Cowork to Frame.io V4 MCP. List assets in your frame.io project, add review comments to a video asset, and more using natural language, with authentication handled for you.

Frame.io V4 logoFrame.io V4
Oauth2

Frame.io V4 is a collaborative media platform for reviewing, managing, and sharing video assets. It gives creative teams one place to organize projects, collect feedback, and manage media workflows.

97 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Frame.io V4 account to Claude via Composio Connect, enabling it to list assets in your Frame.io project, add review comments to a video asset, create a share link for approved footage, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Frame.io V4 with

Connecting Frame.io V4 to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Frame.io V4 account

Back in Claude, ask it to connect to Frame.io V4 or give it any Frame.io V4-related task.

For example, ask Claude to:

  • "List assets in your Frame.io project"
  • "Add review comments to a video asset"
  • "Create a share link for approved footage"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Frame.io V4 account is ready to use.

What is the Frame.io V4 Claude Connector, and what's possible with it?

The Frame.io V4 MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Frame.io V4 account. It provides structured and secure access to projects, media files, folders, comments, shares, metadata, and workspaces, so your agent can organize media, add review comments, create and manage shares, and maintain project information on your behalf.

  • Media and project organization: Have your agent create projects and folders, copy files or folders, build version stacks, and retrieve details about your media.
  • Collaborative media review: Let the agent add text, frame, page, drawing, or text-review comments to files, retrieve comments and replies, and remove comments or attachments when needed.
  • Sharing and reviewers: Direct your agent to create external review shares, add files or folders to them, grant reviewer access, and delete shares when they are no longer needed.
  • Metadata management: Instruct your agent to create or remove account metadata fields and update metadata values across multiple project files.
  • Workspace administration: Have your agent create or delete workspaces, groups, webhooks, and custom actions, and retrieve current details for these resources.

Troubleshooting

1. Why does Claude not use the Composio connector for Frame.io V4?

The connector can show as connected, but Claude must use it in each Frame.io V4 conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Frame.io V4 again.

2. Why does Claude show an MCP server error before Frame.io V4 connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Frame.io V4.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Frame.io V4.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Frame.io V4 authorization link not work?

The Composio connector is one server. Your Frame.io V4 account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Frame.io V4 connection.
  • Composio creates a fresh Frame.io V4 authorization link.
  • Open that link in your browser and finish the Frame.io V4 sign-in.

4. Why do Frame.io V4 actions fail after they worked before?

The Frame.io V4 connection can expire or lose permission.

  • Ask Claude to inspect the Frame.io V4 connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Frame.io V4 account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Frame.io V4.
  • If the action still fails with a permission error, check that the connected account has that permission in Frame.io V4 itself.

5. How do I switch to a different Frame.io V4 account?

Claude can manage the Frame.io V4 connection for you.

  • Ask Claude to disconnect or delete the current Frame.io V4 account.
  • Ask Claude to connect Frame.io V4 again.
  • Open the new Composio authorization link for Frame.io V4.
  • Sign in with the other Frame.io V4 account in the browser.
  • After the account connects, ask Claude to retry the Frame.io V4 task.

6. Why is my Frame.io V4 connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Frame.io V4 connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Frame.io V4 tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Frame.io V4.
TOOLS

Supported Tools

Every Frame.io V4 action and event your agent gets out of the box.

Add Asset to Share

Add a file, folder, or version stack to an existing externally visible Frame.io share.

Add Share Reviewers

Grant reviewers access to a secure Frame.io share or email recipients of a public share.

Bulk Update Metadata

Set metadata field values across multiple files in one Frame.io project.

Copy File

Copy one Frame.io file to a destination folder, optionally copying metadata or comments.

Copy Files

Copy between one and 100 Frame.io files into one destination folder.

Copy Folder

Copy one Frame.io folder to an optional destination folder, optionally retaining metadata values.

Copy Folders

Copy 1 to 100 Frame.io folders into one destination folder, optionally retaining metadata and selected comments.

Copy Version Stack

Create a copy of a Frame.io version stack in its current or a selected destination folder.

Create Comment

Create a text, frame, page, drawing, or text-review comment on a Frame.io file.

Create Comment Attachment

Create an attachment record and upload URLs for an existing Frame.io comment.

Create Custom Action

Create a workspace custom action and return its one-time webhook validation secret with the created action.

Create Folder

Create a named child folder under an existing Frame.io folder and return its new ID.

Create Group

Create an account group that can later receive shared resource access; this changes the account's access-management structure and may require the user-groups plan feature.

Create Local Upload

Create a Frame.io file record and obtain presigned URLs for uploading local file bytes.

Create Metadata Field

Create an account-level Frame.io metadata field definition with type-specific configuration.

Create Project

Create a Frame.io project in a specific workspace.

Create Remote Upload

Start an asynchronous Frame.io upload from a source URL and return its file and status links.

Create Share

Create an externally accessible Frame.io review share for selected project assets.

Create Version Stack

Combine two to ten existing files in one folder into a new ordered Frame.io version stack.

Create Webhook

Register a Frame.io workspace webhook for selected events and return its one-time validation secret.

Create Workspace

Create a Frame.io workspace in an account.

Delete Comment

Permanently delete a Frame.io comment by ID.

Delete Comment Attachment

Permanently delete one attachment from a Frame.io comment.

Delete Custom Action

Delete a Frame.io custom action by ID.

Delete File

Permanently delete a Frame.io file by ID.

Delete Folder

Delete a Frame.io folder by ID; use only when the folder and its contents are no longer needed.

Delete Metadata Field

Delete a mutable account-level Frame.io custom metadata field definition.

Delete Project

Delete a Frame.io project by ID.

Delete Share

Permanently delete a Frame.io review share and disable its externally visible link.

Delete Webhook

Permanently delete a Frame.io webhook registration by ID.

Delete Workspace

Delete a Frame.io workspace from its account by ID.

Get Collection

Return current details for one Frame.io collection by ID.

Get Comment

Return one Frame.io comment by ID, optionally including its owner or replies.

Get Current User

Return the Frame.io user connected through OAuth, including the user ID needed to interpret access and ownership.

Get Custom Action

Return current details for one Frame.io custom action by ID.

Get File

Return one Frame.io file by ID, optionally including creator, project, metadata, or media links.

Get File Upload Status

Return the current completion or failure status of a Frame.io file upload.

Get Folder

Return one folder's current details by ID, optionally including creator, project, or metadata data.

Get Group

Get an account group's details without changing access; this endpoint may require the user-groups plan feature.

Get Project

Return current details for one Frame.io project by ID.

Get Share

Retrieve a Frame.io share's current access, appearance, and review settings without changing it.

Get Version Stack

Retrieve a Frame.io version stack and optionally include related data or media links without changing it.

Get Workspace

Return current details for one Frame.io workspace by ID.

Import File

Import a file from a storage location already configured on the Frame.io account.

List Accounts

List Frame.io accounts available to the connected user and return account IDs for downstream discovery.

List Account Users

List users and their roles in an account, optionally including deactivated users, without changing permissions.

List Audit Logs

List account audit events using Frame.io's experimental audit API, optionally expanding the acting user.

List Collections

List saved collections in a project, including default review-oriented collections and their root folder IDs.

List Comments

List one page of comments on a file, with optional owners, replies, and a next_cursor.

List Custom Actions

List one page of custom actions configured in a Frame.io workspace.

List Files

List one page of files in a folder, with optional media links and a next_cursor.

List Folder Children

List files, folders, and version stacks directly inside a folder, with optional type filtering and media-link expansion.

List Folders

List only the folders directly inside a Frame.io folder, one cursor-controlled page at a time.

List Folder User Roles

List one page of users with direct access roles on a folder without changing access.

List Groups

List one page of account groups and membership counts without changing access; this endpoint may require the user-groups plan feature.

List Invited Projects

List projects where the connected user has project-specific collaborator access but no workspace-level access.

List Metadata Fields

List account metadata field definitions so an agent can discover valid field IDs, types, configuration, and mutability.

List Projects

List a page of projects visible in a Frame.io account, including each project ID and root folder ID for asset traversal.

List Project User Roles

List one page of users with direct project access roles without changing access.

List Recently Deleted Assets

List one page of recently deleted files, folders, and version stacks in a project, ordered by the requested deletion or name sort.

List Share Activities

Return one page of view, download, and comment activity recorded for a Frame.io share.

List Share Assets

Return one page of every direct and recursively nested asset exposed by a Frame.io share.

List Share Reviewers

Return one page of reviewers currently associated with a Frame.io share without changing access.

List Shares

List review shares for a project without creating or changing externally visible review links.

List Version Stack Children

Return one page of files in a Frame.io version stack, with optional related data or media links.

List Version Stacks

Return one page of version stacks directly contained in a Frame.io folder without changing them.

List Webhooks

List webhook registrations in a workspace without creating callbacks or requiring external delivery infrastructure.

List Workspace Projects

List one page of projects in a specific Frame.io workspace.

List Workspaces

List workspaces in an account and return workspace IDs used by project, webhook, and collaboration workflows.

List Workspace User Roles

List one page of users with workspace access roles without changing access.

Move File

Move one Frame.io file to a folder or version stack.

Move Files

Move between one and 100 Frame.io files into one destination folder.

Move Folder

Move one Frame.io folder to a destination folder and return its updated details.

Move Folders

Move 1 to 100 Frame.io folders into one destination folder and return their updated details.

Move Version Stack

Move a Frame.io version stack to a destination folder, changing its parent location.

Remove Asset From Share

Remove an asset from a Frame.io share without deleting the underlying file, folder, or version stack.

Remove Folder User

Remove a user's direct role from a folder, revoking that folder access.

Remove Project User

Remove a user's direct role from a project, revoking that project access.

Remove Share Reviewers

Revoke selected reviewers' access to a secure Frame.io share.

Remove Workspace User

Remove a user's role from a workspace, revoking that workspace access.

Search Account

Search visible projects, folders, files, and version stacks across a Frame.io account by text.

Show Metadata

Return one Frame.io file's metadata values and definitions, optionally including fields with null values.

Show Webhook

Return one Frame.io webhook's current callback, event, status, and optional creator details.

Update Account User Role

Change a user's account-level access to member or admin.

Update Comment

Update the text, location, annotation, timing, or completion state of a Frame.io comment.

Update Custom Action

Update the configuration or active state of a Frame.io custom action.

Update File

Update a Frame.io file's name and return its current details.

Update Folder

Rename an existing Frame.io folder and return its updated details.

Update Folder User Role

Add a user to a folder with the selected role, or replace the role if access already exists.

Update Group

Change an account group's name and/or emoji, altering the group used to organize access; this endpoint may require the user-groups plan feature.

Update Metadata Field

Update the name or type-specific configuration of a mutable account-level Frame.io metadata field definition.

Update Project

Update a Frame.io project's name, restricted state, or status.

Update Project User Role

Add a user to a project with the selected role, or replace an existing role, immediately changing project access.

Update Share

Change a Frame.io share's access, review, appearance, or expiration settings.

Update Webhook

Update a Frame.io webhook's active state, subscribed events, name, or callback URL.

Update Workspace

Update the name of an existing Frame.io workspace.

Update Workspace User Role

Add a user to a workspace with the selected role, or replace an existing role, immediately changing workspace access.

FAQ

Frequently asked questions

Start with Frame.io V4.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Frame.io V4 tool your agent needs.Free to start.

Start building