How to integrate Frame.io V4 MCP with Atomic Agent

Connect Atomic Agent 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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Frame.io V4.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Frame.io V4 account. See the Atomic Agent documentation for installation instructions.

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

Also integrate Frame.io V4 with

How Atomic Agent connects to Frame.io V4

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Frame.io V4 to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Frame.io V4. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Frame.io V4 account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Frame.io V4 MCP server, 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.

Use Frame.io V4 from Atomic Agent

With your account connected, ask Atomic Agent to work with Frame.io V4 in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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