# Vimeo MCP MCP

> Use this MCP to manage your entire Vimeo account structure. Audit videos, list project folders, and monitor content distribution across showcases. Your agent can get detailed video metadata, update titles, and even delete old assets without you having to navigate the platform's dashboard.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** video-hosting, asset-management, video-analytics, media-workflow, showcase-management, content-distribution

## Description

Connecting Vimeo gives your AI client total control over your video asset library. Instead of manually clicking through dashboards to check on content, your agent handles the whole workflow. You can ask it to list all videos in a specific folder or find out exactly how many views a showcase has gathered since last week. Need to clean up old projects? Your agent can audit every item and then use the `delete_video` tool to remove unneeded files. The platform runs securely on Vinkius, which uses a zero-trust proxy for all credential handling, so your access tokens never sit on disk. This means you're performing complex operations—like combining a search query with a folder audit—without ever compromising security.

Your agent acts as an instant video operator: it can browse project folders using `list_folders`, list every showcase using `list_showcases`, and retrieve detailed data, like duration or privacy settings, for any single video. It even lets you search public videos across the platform to find inspiration or relevant community content.

## Tools

### delete_video
Removes a specific video file from your Vimeo account.

### get_me
Retrieves basic authentication details for the connected user.

### get_video
Gets all metadata and performance stats for one specific video file.

### list_channels
Shows a list of channels that the user is following on Vimeo.

### list_folders
Retrieves a list of all project folders you've created in your account.

### list_groups
Lists groups that the user is following on Vimeo.

### list_showcases
Retrieves a list of all showcases (albums) you've created for public distribution.

### list_videos
Lists every video file currently associated with your account.

### search_videos
Searches Vimeo for publicly available videos based on keywords or criteria.

### update_video
Modifies the title, description, and other metadata fields of an existing video.

## Prompt Examples

**Prompt:** 
```
List my last 5 videos in Vimeo.
```

**Response:** 
```
I've retrieved your recent videos. You have 5 files, including 'Client Feedback V2' and 'Final Master'. Would you like the full metadata for any of them?
```

**Prompt:** 
```
Show me my Vimeo project folders.
```

**Response:** 
```
You have 3 projects in Vimeo: 'Corporate', 'Ads 2024', and 'Social Media'. I can list the videos inside any of these folders for you.
```

**Prompt:** 
```
Search for public videos about 'Artificial Intelligence'.
```

**Response:** 
```
I've found several public videos about 'Artificial Intelligence'. The top matches include 'The Future of AI' and 'Deep Learning Explained'. Would you like the links to watch them?
```

## Capabilities

### List all videos
The agent pulls a comprehensive list of every video file associated with your account.

### Audit project folders
It walks through your organized projects and lists the contents, helping you map out content structure.

### Manage showcases
You can list all albums (showcases) and channels to get a view of where your public videos are distributed.

### Update video metadata
The agent lets you change titles, descriptions, or other details for existing videos.

### Delete old content
If a video is retired, the MCP can delete it from your account entirely.

## Use Cases

### Quarterly Content Audit
The Ops Admin needs to check every video's performance and metadata. They ask the agent to `list_videos`, then loop through them using `get_video` to compile a report on all videos older than 6 months that haven't been viewed.

### Project Cleanup
The team finished a campaign and left dozens of draft files. The agent lists the project folders using `list_folders`, identifies outdated content, and uses `delete_video` to clear out the clutter.

### Cross-Platform Promotion Check
The marketer needs to ensure a new video was added everywhere. They check if the video appears in specific showcases using `list_showcases`, and then use `get_video` on each showcase's contents.

### Metadata Correction
A client provided updated branding guidelines, requiring title changes across 50 videos. Instead of logging in fifty times, the agent uses `update_video` with all new descriptions and titles simultaneously.

## Benefits

- Instead of clicking through folder structures to check content, you can use `list_videos` combined with `get_video` to audit metadata (like plays or duration) across hundreds of files instantly.
- Maintain organization by using `list_folders` and `list_showcases`. Your agent gives you a full picture of your project structure without ever requiring manual navigation.
- When content is finished, use `delete_video` to remove retired assets. You don't have to manually track down old files that need cleanup.
- Keep records current using `update_video`. Need to change a video title or description across multiple projects? The agent handles the updates in one prompt.
- Find inspiration fast. Use `search_videos` to query public content, keeping your creative work informed by relevant community examples.

## How It Works

The bottom line is you tell your agent what video audit you need, and it executes the complex sequence of API calls for you.

1. Subscribe to this MCP and provide your Vimeo Access Token.
2. Connect that single credential through your AI client (like Cursor or Claude).
3. Ask your agent a question, like 'List all videos in the Marketing folder,' and get the data back.

## Frequently Asked Questions

**How can I get a list of my projects using the `list_folders` tool?**
The agent runs `list_folders` and returns every project folder ID. This allows you to then target specific folders for video audits or updates.

**Can I delete videos using the `delete_video` tool?**
Yes, that's one of its core functions. You just need to reference the exact ID of the video you want removed from your account.

**Does `get_video` provide performance stats?**
Yep. It pulls detailed metadata, including things like plays and viewership statistics, which is key for marketing audits.

**How does the MCP handle my access token when I use `update_video`?**
The whole process runs securely on Vinkius. It uses a zero-trust proxy to pass your credentials only during transit, meaning they never sit on disk.

**How do I check my current user permissions before running actions like `list_groups`?**
Run the `get_me` tool. This instantly verifies your account's connected status and provides detailed scope information. You can confirm that your agent has the necessary rights for all subsequent operations.

**When using `list_videos`, what metadata fields are available for each video record?**
The tool retrieves deep details, including duration, plays count, and privacy settings. You can prompt your agent to filter or sort these results based on criteria like upload date or visibility status.

**If I query a large number of public videos using `search_videos`, are there rate limits?**
Vinkius handles API throttling automatically. If you exceed the rate limit, your agent receives an explicit error code detailing when to retry the search. This keeps your workflow running smoothly.

**How do I map out which assets belong together using `list_showcases`?**
The output for `list_showcases` includes all associated video IDs and metadata tags. Your agent can use this data to precisely catalog content belonging to a specific project album or showcase.