# Vimeo setup for PopMCP

You paste one value into PopMCP: an access token from a small app you make in Vimeo's developer site. Making the app and the token takes about two minutes, costs nothing and needs no review.

- Auth: API credentials
- Setup time: 2 min
- API base URL: https://api.vimeo.com (Accept: application/vnd.vimeo.*+json;version=3.4)
- Credentials screen: https://developer.vimeo.com/apps
- Provider docs: https://developer.vimeo.com/api/guides/start

## Before you begin

- A Vimeo account you can sign in to
- Nothing to install. The app you make is only a place for the token to live, so any name will do
- A minute to copy the token when it is generated

## Get your credentials

### 1. Open My Apps and start a new app

Sign in to Vimeo and go to developer.vimeo.com/apps. This is the My Apps page. Click Create an app. In Vimeo's terms an app can be as small as a script, so you are not building anything: it only gives the token somewhere to live.

Screen: https://developer.vimeo.com/apps

### 2. Name the app and create it

Give the app any App name, such as PopMCP, and a short Brief description. For Will people besides you be able to access your app? choose No. Tick the box to agree to the Vimeo Developer Addendum and the Vimeo Terms of Service, then click Create App.

Screen: https://developer.vimeo.com/apps/new

### 3. Generate an access token

Vimeo opens your app's page. Scroll to Generate an access token. Pick Authenticated (you), because an Unauthenticated token only sees public data and PopMCP will refuse it. Tick the scopes: Public, Private, Create, Edit, Delete, Interact, Upload and Stats for everything, or Public, Private and Stats for read-only use. Click Generate.

Screen: https://developer.vimeo.com/apps

### 4. Copy the token

The new token appears under Personal Access Tokens on the same page. Copy it right away and keep it private, because anyone who has it can use your account within its scopes. The Client identifier and Client secrets on this page are not tokens, so leave those alone.

Screen: https://developer.vimeo.com/apps

### 5. Paste the token into PopMCP

In PopMCP open Marketplace, find Vimeo, click Connect and paste the token into Access token. PopMCP checks it against your account, names the connection after your Vimeo user and stores the token encrypted.

## Fields PopMCP asks for

- Access token (accessToken) [required]: At developer.vimeo.com/apps choose Create an app (any name and a short description; answer No to whether other people will use it). On the app's page, under Generate an access token, pick Authenticated (you), tick the scopes and click Generate. Copy the token right away. Stored encrypted.

## Verify

PopMCP reads the token's own details, shows the connection under your Vimeo name and notes the scopes it has, including when it is read-only. Asking the AI to list your five newest videos confirms it works.

## Troubleshooting

### "Vimeo did not accept this access token. On your app's page at developer.vimeo.com/apps, generate a new one under Generate an access token and paste that. The Client identifier and Client secret on the same page are not tokens."

Cause: Part of the token was missed when copying, the token was deleted, or the client identifier or a client secret was pasted instead.

Fix: Generate a new token on your app's page, copy the whole value and paste it into PopMCP.

### "This token is Unauthenticated, so it is not tied to your Vimeo account."

Cause: Unauthenticated was picked when the token was generated. That kind only sees public data.

Fix: Generate a new token with Authenticated (you) selected and connect with that.

### A tool answers that it needs a scope

Cause: The token was generated without that scope, and a token cannot gain scopes later.

Fix: Generate a new token with the scope ticked, then reconnect Vimeo in PopMCP with it.

### Vimeo refuses an upload

Cause: Your app may need upload access. Vimeo's guide asks for it before uploading, and a Vimeo Free account has to ask through support.

Fix: On your app's page find Upload Access under Permissions and choose Request Upload Access. On a Free account, open a ticket with Vimeo support instead.

### A connection that used to work now fails

Cause: Vimeo automatically deletes tokens that look inactive, or the token was deleted under Personal Access Tokens.

Fix: Generate a new token and reconnect Vimeo in PopMCP.

### A team's videos do not show up

Cause: A token belongs to one Vimeo user and works on that user's library by default.

Fix: Ask the AI to use the team owner's user id. Your Vimeo user must be on the team, and Vimeo applies your role there.

---

Source: https://www.docs.popmcp.com/docs/integrations/vimeo/