media
Vimeo CLI for Headless Automation
Use the Vimeo CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 5 read 1 write Bearer token auth
Vimeo CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Vimeo CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Vimeo CLI for Headless Automation
kosmokrator integrations:configure vimeo --set access_token="$VIMEO_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call vimeo.vimeo_create_video '{"upload_approach":"example_upload_approach","upload_link":"example_upload_link","name":"example_name","description":"example_description","privacy":"example_privacy","password":"example_password","folder_uri":"example_folder_uri"}' --jsonDiscovery Before Execution
Agents and scripts can inspect Vimeo docs and schemas before choosing a function.
kosmo integrations:docs vimeo --json
kosmo integrations:docs vimeo.vimeo_create_video --json
kosmo integrations:schema vimeo.vimeo_create_video --json
kosmo integrations:search "Vimeo" --json
kosmo integrations:list --jsonUseful Vimeo CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
vimeo.vimeo_create_video | Write | upload_approach, upload_link, name, description, privacy, password, folder_uri | Create a new video upload slot on Vimeo. Choose an upload approach: "pull" (Vimeo downloads from a URL), "post" (you POST to an upload link), or "streaming" (Tus protocol). Returns the video URI and upload target. |
vimeo.vimeo_get_current_user | Read | none | Get the authenticated Vimeo user's profile information. Returns name, bio, location, account type, upload quota, and profile pictures. |
vimeo.vimeo_get_video | Read | video_id | Get detailed information about a single Vimeo video by its ID. Returns name, description, duration, thumbnails, privacy, stats, and playback links. |
vimeo.vimeo_list_albums | Read | per_page, page, query, sort, direction | List albums (showcases) for the authenticated Vimeo user. Supports pagination, query search, sorting, and direction. Returns album names, descriptions, thumbnails, and video counts. |
vimeo.vimeo_list_folders | Read | per_page, page, query | List folders (projects) for the authenticated Vimeo user. Supports pagination and query search. Returns folder names, descriptions, and item counts. |
vimeo.vimeo_list_videos | Read | per_page, page, query, filter, filter_embeddable, filter_playable, direction, sort | List videos for the authenticated Vimeo user. Supports pagination, full-text search via query, and filters (e.g., embeddable, playable, privacy). Returns video URIs, names, durations, thumbnails, and metadata. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.