Vimeo
Vimeo is a video platform for hosting, managing, sharing, and interacting with video content and account resources.
Verdict
Common use cases
- Audit video library before campaign launch
- Check user upload quota and tier limits
- Pull channel stats for monthly reporting
- Verify group membership for collaboration workflows
- Catalog public categories for content planning
Integration
- Vendor
- Vimeo
- Category
- other
- Auth
- OAUTH2
- Tools
- 50
- Composio slug
vimeo
Tools
- Get Category
Get one public Vimeo category by slug.
- Get Channel
Get one public Vimeo channel by numeric ID.
- Get Current User
Return the connected Vimeo user's numeric user ID, profile, account tier, capabilities, and resource counts. Use the ID with user-subject tools for self workflows.
- Get Group
Get one public Vimeo group by numeric ID.
- Get On Demand Genre
Get one public Vimeo On Demand genre by ID. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- Get On Demand Region
Get one public Vimeo On Demand catalog region by country code. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- Get On Demand Season
Get one season of a public Vimeo On Demand title. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- Get On Demand Title
Get one public Vimeo On Demand title. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- Get Tag
Get one public Vimeo tag by word.
- Get User
Get one public Vimeo user profile.
- Get Video
Return metadata only for a public Vimeo video whose privacy.view is 'anybody'. Private, password-protected, team-only, unlisted, and otherwise restricted IDs are treated as inaccessible even when the connected token can view them; use LIST_
- List Categories
Return one sortable page of Vimeo's public video categories for discovering category slugs.
- List Category Channels
Return one page of public channels assigned to a Vimeo category. Vimeo currently returns an internal error for search queries containing apostrophes; no escaping is applied. Pass next_cursor as cursor to continue.
- List Category Groups
Return one page of public groups assigned to a Vimeo category. A search query must contain at least one letter or digit. Vimeo currently returns an internal error for queries containing apostrophes; no escaping is applied. Pass next_cursor
- List Category Videos
Return one sortable, filterable page of public videos in a Vimeo category. Vimeo's category-video endpoint currently fails non-empty search queries.
- List Channel Categories
List categories assigned to a public Vimeo channel. Vimeo returns the full relation; limit trims the returned data client-side and does not reduce provider data transfer.
- List Channel Followers
Return one page of followers of a public Vimeo channel. This is distinct from channel moderators. Vimeo supports sorting and pagination for this follower list, but not search. Pass next_cursor as cursor to continue.
- List Channel Moderators
Return one page of moderators of a public Vimeo channel. Pass next_cursor as cursor to continue.
- List Channels
Return one searchable, sortable page of Vimeo's public curated channels.
- List Channel Tags
List tags assigned to a public Vimeo channel. Vimeo returns the full relation; limit trims the returned data client-side and does not reduce provider data transfer.
- List Channel Videos
Return one searchable, sortable page of public videos in a Vimeo channel.
- List Custom Logos
Return one page of custom player logos owned by the connected Vimeo user. Custom logos depend on the Standard or Advanced Embed Presets feature; a Free account may return a successful empty list. Pass next_cursor as cursor to fetch the next
- List Embed Presets
Return one page of embed presets for the connected Vimeo user, or for the Vimeo user selected by optional user_id. Embed presets depend on the Standard or Advanced Embed Presets feature; a Free account may return a successful empty list. Pa
- List Folders
Return one page of folders owned by the connected Vimeo user.
- List Group Members
Return one page of members of a public Vimeo group. Pass next_cursor as cursor to continue.
- List Groups
Return one page of searchable, sortable public Vimeo groups. Pass next_cursor as cursor to continue.
- List Group Videos
Return one page of public videos in a Vimeo group. Pass next_cursor as cursor to continue.
- List My Videos
Return one searchable, sortable page of videos uploaded by the connected Vimeo user, including private videos visible to the grant. Use next_cursor to retrieve the next page. Vimeo's deprecated include_team_content input is intentionally om
- List On Demand Genres
List Vimeo On Demand catalog genres. Vimeo returns the full catalog; limit trims the returned data client-side and does not reduce provider data transfer. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20,
- List On Demand Posters
List one page of poster artwork for a public Vimeo On Demand title and return next_cursor. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- List On Demand Regions
List countries and regions in the public Vimeo On Demand catalog. Vimeo returns the full catalog on every request; this action trims it client-side and returns a local cursor until every region is reachable. Vimeo On Demand is being discont
- List On Demand Seasons
List one page of seasons for a public Vimeo On Demand title and return next_cursor. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- List On Demand Season Videos
List one page of On Demand season video metadata and return next_cursor; playback entitlement is not implied. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- List On Demand Title Genres
List genres assigned to a public Vimeo On Demand title. Vimeo returns the full relation; limit trims the returned data client-side and does not reduce provider data transfer. Vimeo On Demand is being discontinued; these reads are expected t
- List On Demand Titles By Genre
List one page of public Vimeo On Demand titles in a genre and return next_cursor. my_region is the only supported region filter; country is unsupported and rejected. Vimeo On Demand is being discontinued; these reads are expected to stop af
- List On Demand Title Videos
List one page of On Demand title video metadata and return next_cursor; playback entitlement is not implied. Vimeo On Demand is being discontinued; these reads are expected to stop after Nov 20, 2026.
- List Portfolios
Return one page of portfolios for the connected Vimeo user, or for the Vimeo user selected by optional user_id. Portfolios are available with Standard or Advanced; a Free account may return a successful empty list. Pass next_cursor as curso
- List Showcases
Return one searchable, sortable page of Showcases owned by the connected Vimeo user.
- List User Feed
Return one page of Activity records from a Vimeo user's feed. Use GET_CURRENT_USER to obtain the connected user's ID for self workflows. Use next_cursor to retrieve the next page.
- List User Folders
Return one page of folders belonging to a Vimeo user or team owner. Vimeo's legacy API path calls folders projects; pass next_cursor as cursor to continue.
- List User Followed Categories
Return one page of categories followed by a Vimeo user. Use GET_CURRENT_USER to obtain the connected user's ID for self workflows. Use next_cursor to retrieve the next page.
- List User Followed Channels
Return one page of channels followed by a Vimeo user. Use GET_CURRENT_USER to obtain the connected user's ID for self workflows. Use next_cursor to retrieve the next page.
- List User Followers
Return one page of followers of a Vimeo user. Use next_cursor to retrieve the next page.
- List User Following
Return one page of users followed by a Vimeo user. Use next_cursor to retrieve the next page.
- List User Liked Videos
Return one page of videos liked by a Vimeo user. Use next_cursor to retrieve the next page.
- List User Pictures
Return one page of profile pictures for a Vimeo user. Use next_cursor to retrieve the next page.
- List User Watch Later
Return one page of videos in a Vimeo user's Watch Later queue. Use GET_CURRENT_USER to obtain the connected user's ID for self workflows. Use next_cursor to retrieve the next page.
- List Video Categories
List categories assigned to a public Vimeo video.
- List Video Likers
Return one page of users who liked a public Vimeo video. Use next_cursor to retrieve the next page.
- Search Users
Return one page of public Vimeo user profiles matching a search. Use next_cursor to retrieve the next page.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Integrations in the left sidebar. 2. Find Vimeo in the catalog and click Connect. 3. You'll be redirected to Vimeo's OAuth consent screen; sign in with the account you want to query. 4. Grant the requested read scopes—these let Switchy fetch public video data and your user profile. 5. After approving, Vimeo redirects you back to Switchy and the integration appears as connected. 6. Open any Project and type '@Vimeo get current user' to confirm the connection returns your numeric user ID and account details. 7. From there, use channel IDs or category slugs in prompts to pull the metadata you need.
What teammates see: by default, memories from Vimeo are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Check My Account Status
@Vimeo get my current user profile and tell me my account tier, remaining upload quota, and any capability limits I should know about.
Fetch Channel Overview
@Vimeo get the channel with ID 12345 and summarize its name, description, video count, and follower stats.
List Category Details
@Vimeo get the category with slug 'animation' and show me its name, description, and top-level metadata.
Verify Group Membership
@Vimeo get the group with ID 67890 and tell me its name, privacy setting, member count, and description.
Pull On Demand Genre
@Vimeo get the On Demand genre with ID 111 and list its name, canonical URL, and any associated metadata.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Vimeo look up channel 987654 and summarize what kind of content they publish
Channel 987654 ('Indie Filmmakers Collective') has 1,240 videos and 18,500 followers. The channel focuses on short narrative films, behind-the-scenes production diaries, and festival Q&A sessions. Recent uploads include a 15-minute sci-fi short, a cinematography breakdown, and a panel discussion from Sundance. The channel description emphasizes supporting emerging directors and experimental storytelling.
This example pairs Get Channel with AI synthesis to extract thematic patterns from metadata. Only works with public channels—private or password-protected channels return limited data even with OAuth2. The AI infers content focus from titles and descriptions; it cannot watch videos or analyze visual content directly.
Use-case deep-dives
When Vimeo MCP makes sense for content inventory work
A 6-person marketing team publishes 40-60 videos per quarter across product demos, webinars, and case studies. They need to audit which videos are public, which channels they're in, and what metadata is missing before a rebrand. The Vimeo MCP's 50 tools cover category, channel, and group reads—enough to pull a full inventory snapshot without opening the web UI. OAuth2 means each team member authenticates once and the workspace sees their own library. The catch: if you're only checking upload status or embedding a few videos, the native Vimeo dashboard is faster. This MCP wins when you're cross-referencing 20+ videos against channels or groups in a single session, or when you're building a recurring audit workflow that references the same library structure weekly.
Using Vimeo MCP to surface support videos in Slack threads
A 3-person customer success team maintains 80 tutorial videos in Vimeo, organized by product feature and user role. During support threads in Slack, they want to drop the right video link without hunting through folders. The Vimeo MCP lets the AI pull video metadata by channel or category, so the team can ask 'show me the onboarding videos for enterprise admins' and get a list with titles and links. The limitation: the MCP doesn't search video transcripts or captions, so if your knowledge base depends on finding a specific phrase inside a video, you'll still need Vimeo's native search. This setup works when your video library is well-tagged and under 200 assets—beyond that, response times start to lag and you're better off syncing metadata to a dedicated search tool.
When Vimeo MCP helps solo creators manage client deliverables
A solo video producer delivers 8-12 projects per month, each with 3-5 final cuts uploaded to client-specific Vimeo folders. At month-end, they need to confirm which videos are live, which are still private, and pull download links for invoicing. The Vimeo MCP's user and channel tools let them query their own account in one pass, without clicking through each folder. OAuth2 means they authenticate once and the workspace remembers their credentials across sessions. The trade-off: if you're uploading or editing video settings (privacy, embeds, thumbnails), the MCP is read-only—you'll still need the Vimeo web UI for writes. This integration shines when you're doing regular status checks or generating client reports, not when you're actively managing uploads or permissions.
Frequently asked
What does the Vimeo MCP do in Switchy?
It pulls metadata from your Vimeo account — user profiles, channel details, categories, groups, and On Demand catalog info. You can query video collections and account capabilities without leaving Switchy. It doesn't upload or edit videos; it reads public and account-scoped data so your team can reference Vimeo content in workflows.
Which OAuth scopes does the Vimeo MCP request?
Vimeo uses OAuth2, but the exact scopes depend on which tools you call. At minimum it needs public read access. If you use Get Current User or account-specific tools, it requests profile and private data scopes. You authorize once in Switchy; the MCP handles token refresh automatically.
Can the Vimeo MCP upload or delete videos?
No. The 50 tools are all read operations — fetching categories, channels, user details, and On Demand titles. If you need to upload, transcode, or manage video settings, use Vimeo's native app or their upload API directly. This MCP is for pulling metadata into Switchy conversations, not content management.
How is this different from just opening Vimeo in a browser?
The MCP lets AI agents query Vimeo data mid-conversation without context switching. Instead of manually copying channel IDs or genre lists, the agent fetches them on demand. It's faster for repetitive lookups and keeps everything in one workspace, but you lose Vimeo's visual player and editing UI.
Who on the team should connect the Vimeo account?
Whoever owns the Vimeo account you want to query. If your team shares one Vimeo Pro or Business account, that admin should authorize the MCP in Switchy. The connection is workspace-wide, so everyone in Switchy can reference the same Vimeo data without re-authenticating.