# Vimeo MCP

> Vimeo MCP gives your AI agent full control over your video assets. Search, retrieve metadata, update descriptions, delete old content, and manage uploads—all without leaving your development or marketing workflow.

## Overview
- **Category:** image-video
- **Price:** Free
- **Tags:** video-hosting, video-api, content-creation, media-management, vimeo-api

## Description

Manage every piece of media you own directly through conversation. This connection lets your agent treat Vimeo like a simple database: you ask for it, the agent finds it, and you tell it what to do with it. You can search across your entire video library, pinpoint specific videos by ID, and pull detailed metadata on any asset. Need to update descriptions or change privacy settings? Just tell the agent to run an update. This isn't just about listing files; it's about building full content workflows. If you need to combine this with a customer record system—say, pulling a client list from a CRM and then automatically attaching relevant video tutorials—that's where Vinkius comes in. You can chain multiple MCPs together so your AI agent builds an automation that spans platforms. It keeps all those sensitive credentials secure using a zero-trust proxy, meaning your keys never sit on disk. All you do is connect once from Claude, Cursor, Windsurf, or any other compatible client.

## Tools

### create_video_upload
Generates a ticket that prepares the system for a new video upload.

### delete_video
Removes an existing video from your Vimeo library entirely.

### get_channel
Retrieves all details about a specific channel on the platform.

### get_group
Fetches information for a designated content group or showcase.

### get_me
Gathers and returns your personal user profile details on Vimeo.

### get_user
Retrieves the complete profile data for any specified user account.

### get_video
Pulls all metadata and information about one single video asset.

### list_my_videos
Generates a list of every video uploaded by your connected account.

### list_user_albums
Lists all the curated showcase albums associated with a user's profile.

### list_user_followers
Outputs a list of all accounts that follow a specific Vimeo user.

### list_user_videos
Gets a filtered list of videos uploaded by one particular user account.

### search_videos
Searches the entire Vimeo platform for videos using keywords or filters.

### update_video
Changes metadata, descriptions, or settings for an existing video asset.

## Prompt Examples

**Prompt:** 
```
List my most recent videos on Vimeo.
```

**Response:** 
```
I've retrieved your latest uploads. You have 3 recent videos: 'Product Demo' (ID: 88231), 'Team Sync' (ID: 88245), and 'Tutorial Part 1' (ID: 88250). Would you like to see the details for any of these?
```

**Prompt:** 
```
Search for videos about 'artificial intelligence' on Vimeo.
```

**Response:** 
```
Searching Vimeo... I found several videos. The top results include 'AI Revolution 2024' and 'Understanding Neural Networks'. Should I provide more info on these?
```

**Prompt:** 
```
Update the description of video 88231 to 'Updated product walkthrough'.
```

**Response:** 
```
The video metadata has been updated successfully. Video ID 88231 now has the description: 'Updated product walkthrough'.
```

## Capabilities

### Search and discover content
Find specific videos across the entire platform using keywords, categories, or user names.

### Manage video metadata
Change titles, descriptions, and other details for existing videos without logging into Vimeo's website.

### List and inspect assets
Retrieve comprehensive lists of all videos uploaded by you or by specific users within your network.

### Handle content lifecycle
Create tickets for new video uploads or delete old, unnecessary media files.

### Access user details
Pull profile information and follower lists for specific users on the platform.

## Use Cases

### Archiving obsolete content
The Content Director finds 50 old training videos that need to be pulled from circulation. Instead of manually deleting them, they ask the agent to use `delete_video` on all assets tagged 'Q1-2020' and confirm the action.

### Auditing a client's media presence
The Marketing Manager needs to know every video associated with a key brand partner. They use `list_user_videos` for that user, then feed those IDs into another MCP to check their billing status.

### Updating product launches in bulk
A new version of a demo reel goes live. The agent first uses `get_video` to pull the old metadata for ID 88231, then immediately calls `update_video` with the fresh title and description.

### Onboarding a new team member
The Ops Engineer needs to see who has access to key assets. They use `list_user_followers` on the main company channel, getting an immediate roster of viewers for review.

## Benefits

- Instead of logging into the web portal to change details, you simply tell your agent to `update_video` metadata for a specific asset. This keeps the action right inside your current workflow.
- You never have to guess where an old asset is; use `search_videos` to find content across the whole platform instantly. It cuts down on manual searching time dramatically.
- Need to know who follows a key contributor? Use `list_user_followers` to pull that list directly into your agent's memory for reporting, instead of navigating profile tabs.
- When you need to prepare new content, use `create_video_upload` to generate the necessary ticket. This is faster than clicking through multiple setup forms.
- The ability to chain this MCP with others means you can find a video (`get_video`), send its link via messaging, and log the interaction in a CRM—all in one go.

## How It Works

The bottom line is that you treat video management as another function of your AI workflow—just another tool call.

1. Subscribe to this MCP and provide your Vimeo Personal Access Token.
2. Connect from any compatible AI client (Claude, Cursor, etc.)
3. Prompt your agent with a command like 'Find all videos related to Q3 sales' to execute the task.

## Frequently Asked Questions

**Can I update the privacy settings of my videos through the AI?**
Yes! You can use the `update_video` tool to change the `privacy_view` setting to options like 'anybody', 'nobody', or 'unlisted'.

**Is it possible to search for videos globally on Vimeo?**
Absolutely. The `search_videos` tool allows you to perform a global search using a query string and filter results by sort order and direction.

**Can I see who is following a specific user?**
Yes, the `list_user_followers` tool retrieves the list of followers for any given user ID on the platform.

**What information does the `get_me` tool provide about my authenticated user profile?**
It returns a structured object detailing your account's core metadata. This includes basic profile details, such as your unique user ID and general subscription status.

**If I run `list_user_albums`, what structure of information can I expect regarding content showcases?**
You receive a list that defines the albums' boundaries. Each entry includes the album title, its unique ID, and details on how many videos are categorized within that showcase.

**How does using `create_video_upload` initiate the process of adding new content to my library?**
It generates a specific upload ticket for your account. This ticket establishes the necessary prerequisites and metadata required before you can actually transfer or attach video files.

**What is the correct procedure for using `delete_video` to permanently remove content?**
You must provide the unique ID of the video you want gone. The tool executes the deletion immediately, and it's important to confirm the ID before running the command.

**When I use `list_user_videos` for another user, what specific data points are available for each uploaded video?**
You get a list that includes every video's title, its unique ID, and key metadata like the upload date. This allows you to quickly review a user's entire history.