# Connectors: Google Drive, Dropbox, YouTube and X

Source: [Connectors: Google Drive, Dropbox, YouTube and X](<https://pr-1026-preview.chatcut.dev/docs/connectors>)

Documentation index: [llms.txt](<https://pr-1026-preview.chatcut.dev/docs/llms.txt>)

Last updated: 2026-11-20

Connectors link ChatCut to accounts you already use. Use **Google Drive** or **Dropbox** to bring media into a project, **YouTube** to upload an export to your channel, and **X** to publish a post.

## Which connectors can I use?

-   **Dropbox and X, in ChatCut Desktop 0.9.1 or later and in the web app.**
-   **Google Drive and YouTube** appear in ChatCut Desktop 0.9.17 or later and in ChatCut Web. Use them in the project editor or its Agent chat. The hosted Agent Plugin offers Dropbox and X only.
-   **You must be signed in** to ChatCut. Connecting needs your ChatCut account first.

## How do I connect an account?

Connect from the chat box of a project:

1.  Open a project and its Agent chat.
2.  Click **+** in the chat box and choose **Connector**.
3.  Click **Connect** next to the service. Your browser opens the provider’s own sign-in and consent page. On the web, allow the pop-up if your browser blocks it.
4.  Approve access there. Back in ChatCut, the row’s button changes to **Details**.

You can also open **Connectors** in the home sidebar on the web or in Desktop 0.9.17 or later. If the connection action is unavailable, check again before starting an import or upload.

You can also ask the Agent, for example “Connect my X account.” It shows a **Connect X** button in the chat. Only your click starts the sign-in, and you sign in on X’s page yourself. The Agent cannot sign in or approve access for you. Once you are connected, it continues the task in the same chat.

If the sign-in times out or you cancel, click **Connect** again. If an account’s access expired, its row shows **Reconnect**. Connecting is not permission to post or upload anything. It only links the account.

## What can ChatCut read from my accounts?

-   **Dropbox:** read-only. ChatCut asks to read your account info, file names and file contents so it can list and download media you choose. It cannot edit or delete your Dropbox files.
-   **X:** ChatCut asks to read your posts and profile and to create posts and upload media for them. It uses these to publish a post you approve and to read statistics for your own posts.
-   **Google Drive:** Google Picker grants access to the files you select. ChatCut can download those files for the project.
-   **YouTube:** ChatCut identifies your channel, uploads approved videos and reads the processing status and statistics of your own videos.
-   ChatCut does not show you or the Agent your sign-in credentials.

## How do I bring Dropbox media into a project?

1.  Click **+** in the chat box, choose **Connector**, then **Dropbox**.
2.  Search by file name or browse the list. ChatCut lists audio, video, images, GIFs and SVGs.
3.  Select files and click **Add to chat**. You can add up to 20 files at a time.

Choosing a file attaches a reference to it. ChatCut downloads the original into your project only when the task needs the whole file, for example to read, transcribe or edit it. A reference alone is enough for the Agent to name the file or look at its thumbnail.

Attaching is not the same as importing:

-   **Attached reference:** a pointer to the Dropbox file at the version you selected. Nothing is copied yet.
-   **Imported media:** the original file is downloaded into the project’s Media Pool and can go on the timeline. The Agent does this for you when the task needs it. Transcription is skipped unless you ask for it.
-   ChatCut never silently switches to a newer version of the file. If the file changed, select it again.
-   If you attach the same file again, ChatCut reuses the copy already in the project.

## How do I import Google Drive files?

1.  In a project, open **\+ → Connector → Google Drive** and connect your Google account.
2.  Open **Choose from Google Drive** on the web or **Choose Drive files** on Desktop. Select the media in Google Picker, then select the files you want to use in ChatCut.
3.  On the web, add the selected files to import them into the project’s Media Pool. In Desktop, use **Import selected** in the project library, or **Add to chat** in the chat picker. A chat attachment references the file until the Agent needs the original.

## What are the file size limits?

| Media | Limit |
| --- | --- |
| Dropbox and Google Drive audio and video (ChatCut Desktop) | Up to 1 GiB per file |
| Dropbox and Google Drive images, GIFs and SVGs (ChatCut Desktop) | Up to 512 MiB per file |
| X video (MP4) | 0.5 to 140 seconds, aspect ratio between 1:3 and 3:1, up to 128 MiB |
| YouTube MP4 | Up to 512 MiB. The Web Agent accepts a local MP4 export up to 128 MiB from the same editor tab. |

## How do I publish to X?

1.  Export your video as an MP4 from the project. On the web, export it locally in the same editor tab and keep that tab open; a cloud export or an export saved to a file cannot be used. A post can also be text alone or carry up to four images from the project.
2.  Connect X from the chat box (**+** > **Connector** > **X**), then ask the Agent to publish. Include the post text.
3.  The Agent prepares a draft without uploading anything. It names the account, shows a form in the chat with the media and the post text, and tells you how many credits the post costs.
4.  Edit the text if you need to, then submit the form. Nothing is uploaded or charged before you submit.
5.  ChatCut uploads the media, creates the post and follows it until it is published. The Agent replies with a link to the live post.

Things to know:

-   **You confirm, never the Agent.** The Agent cannot submit the form for you. If you edit the text so the post would cost more, nothing is posted and you confirm a new draft. A new draft replaces one you have not submitted, and an unsubmitted draft is lost if you refresh or restart.
-   **Posting without a review is opt-in.** Only when you explicitly ask the Agent to post without confirming, and give it the complete post, does it publish in one step.
-   **Links cost more.** X charges far more for posts that contain a link, and the Agent tells you when that applies.
-   **Posts are public.** X has no private drafts, so a post from a public account is visible right away. For a protected account, only approved followers see it.
-   **Post text** is limited to 280 characters.
-   **An uncertain result is not retried.** If ChatCut cannot tell whether a post went through, it shows **Publication status is uncertain. Check its status before trying again.** Ask the Agent to check the post’s status rather than publishing again.

Credits for publishing are charged to your ChatCut balance. See [Credits](https://pr-1026-preview.chatcut.dev/docs/credits-policy) for how credits work.

## How do I upload an export to YouTube?

1.  Open the project and connect YouTube with a Google account that identifies exactly one YouTube channel.
2.  Export an MP4. On the web, open the local export preview in the same tab and click **YouTube**, or ask the project’s Agent to prepare that local export for upload. In Desktop, ask the Agent to upload a completed MP4 export from the current project.
3.  Check the channel and video, enter a title, and specify whether the video is made for kids.
4.  On the web, choose **Upload as private** and keep the tab open. You can publish the video later in YouTube Studio. Desktop also defaults to private. You may explicitly choose unlisted or public. Check the visibility YouTube actually returns.
5.  Check processing before sharing the link. If the outcome is unclear, check YouTube Studio before trying again.

## How do I read statistics for my posts and videos?

Ask the project Agent how your posts or videos are doing.

-   **X:** it can read up to 100 of your own posts by ID, or a page of your recent posts. **Impressions** are how many times a post was shown, which is not the same as video views. **Video views** are reported separately, for the attached video, when X provides them.
-   **YouTube:** ask for the statistics of a video you own by its title or URL, or ask for recent uploads. A lookup by ID accepts up to 50 owned videos.
-   A missing number means the platform did not provide it. It does not mean zero.
-   There are no date-range, watch-time or revenue reports.
-   A handful of posts is a small sample. The Agent should report what it measured and not guess at why a post did or did not spread.

Reading statistics does not use ChatCut credits. X may still count these requests against its own API usage limits.

To see what you have posted to X, click **+** in the chat box, choose **Connector**, then **Details** next to X. Your posts are listed under **Published**.

## Prompts you can copy

Prompt

```text
Connect my X account.
```

Prompt

```text
Look through my Dropbox for the clip named interview-raw and add it to this project. Skip transcription for now.
```

Prompt

```text
Publish my latest MP4 export to my connected X account with this text: 'Behind the scenes of our new product launch'.
```

Prompt

```text
Show impressions and video views for my last five X posts, and tell me which numbers X did not return.
```

## What about privacy?

-   **Dropbox files** stay where they are until you select them. ChatCut reads only what you choose and imports a file only into the project you are working in.
-   **Disconnecting** removes the link from ChatCut.
-   **Publishing** sends the post or video you approve to X or YouTube. Nothing is uploaded until you confirm.

## What are the limits and tips?

-   **Desktop and web.** Use the project editor for the full connector list. See [ChatCut product facts](https://pr-1026-preview.chatcut.dev/docs/product-facts) for how Desktop differs from the web app.
-   **Keep the project open** while a post or upload finishes. On the web, keep the tab open.
-   **Choose the right project.** A Dropbox or Google Drive selection belongs to the project and chat where you made it. If either changes, select the files again.

## What related pages can I read?

-   [Credits](https://pr-1026-preview.chatcut.dev/docs/credits-policy)
-   [ChatCut product facts](https://pr-1026-preview.chatcut.dev/docs/product-facts)
-   [Export video, audio and subtitles](https://pr-1026-preview.chatcut.dev/docs/export-video-audio-subtitles)
