# Vimeo MCP

> Vimeo MCP manages your entire video library within a conversation. You can audit content, list videos across different folders or showcases, retrieve detailed metadata (like plays and duration), update titles, and delete old assets—all without ever opening the Vimeo dashboard. It turns complex media governance into simple instructions for your AI agent.

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

## Description

This connector gives your AI client full command over your video ecosystem on Vimeo. Forget clicking through dozens of tabs just to find out which videos need updates or where a specific project folder is located. Instead, you simply ask the agent what you need—whether it's finding all the videos associated with 'Q3 Campaign' or checking the performance stats for a particular showcase.

The system lets your agent list every video and retrieve its detailed metadata, letting you govern content governance from a natural chat interface. You can audit entire project folders to ensure everything is organized before a client review. If you need to update descriptions, change titles, or even delete outdated media assets, the agent handles it immediately.

By connecting Vimeo through Vinkius, your AI agent acts as an expert video operations specialist for your team. It lets you query public videos across Vimeo for inspiration and keeps track of user-specific channels and groups. You get a single point of access to organize and manage every aspect of your visual content.

## Tools

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

### get_me
Retrieves basic profile information for the authenticated user on Vimeo.

### get_video
Fetches detailed information about a single, specific video file.

### list_channels
Shows all public or private channels that your account follows on Vimeo.

### list_folders
Retrieves a list of project folders (groups) associated with the user's account.

### list_groups
Lists all groups that your account follows on Vimeo.

### list_showcases
Returns a list of curated showcases (albums) used to group videos.

### list_videos
Generates a comprehensive list of all videos uploaded by the user.

### search_videos
Searches for public videos across Vimeo based on keywords or topics.

### update_video
Changes the metadata, such as the title or description, for 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

### Audit Video Assets
List all videos in your account and retrieve specific metadata like duration, play counts, and privacy settings.

### Organize Projects and Content
Browse lists of project folders (groups) or content showcases (albums) to map out your video structure.

### Manage Video Metadata
Update the titles, descriptions, and other key details for specific videos on Vimeo.

### Control Content Lifecycle
Delete old or unnecessary video files directly from your agent chat session.

### Search Public Media
Query public-facing videos across Vimeo to find relevant industry content or ideas.

## Use Cases

### Quarterly Content Audit
The Account Admin needs to ensure that every video in the 'Client Portfolio' folder has a standardized description. Instead of opening 50 videos one by one, they ask the agent to list all videos and then use `update_video` on a batch, ensuring consistency across the whole collection.

### New Campaign Launch Prep
The Content Manager needs to confirm that 12 new assets are ready. They ask the agent to list all videos and then use `get_video` on each one to verify its privacy settings and final duration before scheduling a public release.

### Disposing of Old Media
The Operations Lead has old training materials that need clearing out. They instruct the agent to list all videos, filter by date, and then use `delete_video` on anything older than two years.

### Cross-Team Content Review
A Producer needs to check what kind of content exists in the 'Experimental' folder. They ask the agent to list folders and then specifically request a listing of videos within that project using `list_videos`.

## Benefits

- Automate Content Governance: Instead of manually checking titles, use the agent to run `list_videos` and then `update_video` across hundreds of files to standardize descriptions instantly.
- Maintain Structure Oversight: The agent lets you browse all project folders using `list_folders`, giving you a real-time map of your content organization without navigating dozens of internal links.
- Save Time on Audits: Use `list_videos` and `get_video` to pull detailed metadata (plays, duration) for every file in minutes. This replaces hours spent opening individual video dashboards.
- Clean Up Assets Safely: When a project ends, you can command the agent to use `delete_video`, ensuring no outdated or unnecessary content remains cluttering your library.
- Find Inspiration Fast: Use `search_videos` to query public content across Vimeo. You find relevant industry examples without leaving your workflow and wasting time on Google searches.

## How It Works

The bottom line is you get full control over your entire Vimeo content library through simple conversation, without needing manual logins or dashboard navigation.

1. Subscribe to the Vinkius catalog and provide your Vimeo Access Token.
2. Connect this MCP to your preferred AI client (e.g., Cursor, Claude, Windsurf).
3. Instruct your agent to perform a task, like listing all project folders or updating video descriptions.

## Frequently Asked Questions

**How does the Vimeo MCP handle listing all my videos?**
The `list_videos` tool retrieves every video file uploaded by your account. It gives you a comprehensive overview, including key metadata like duration and play counts.

**Can I update descriptions for many videos at once using Vimeo MCP?**
Yes. You use the `update_video` tool. Instead of logging in and updating each video manually, you instruct your agent to change the metadata (like the title or description) across a set list of files.

**What if I want to find public videos about AI?**
For general inspiration, use the `search_videos` tool. This searches Vimeo's publicly available content using keywords, helping you find relevant industry examples quickly.

**Is deleting a video permanent with the Vimeo MCP?**
Yes, the `delete_video` tool permanently removes the asset from your account. Always run a detailed audit first to ensure you don't delete anything important.

**Does Vimeo MCP help me manage my client groups?**
It helps by allowing you to list all folders and groups using `list_folders` or `list_groups`, giving you a clear, conversational overview of your content structure.