Google Drive

Connect a Google account to manage files and folders in Google Drive. metamorphOS can create folders, upload and download files, rename, move, copy, share, and delete content, and search the files it has access to.

What you can do

• Files: upload a file, download a file, get a file’s details, rename, move, copy, or permanently delete it.
• Folders: create a folder, optionally inside another folder, and move files between folders.
• Search: list or search the files and folders the connection can access.
• Sharing: share a file or folder with a person, group, domain, or anyone, and set whether they can view, comment, or edit.

Before you start

You need a Google account and access to the Google Cloud Console so you can create a project and OAuth credentials. To let others connect while the app is in testing, you also need to add them as test users.

Set up Google

All provider-side setup happens in the Google Cloud Console (https://console.cloud.google.com ).

1. Create or select a project. In the project picker, create a new project (for example, metamorphOS) or select an existing one. The remaining steps apply to that project.
2. Enable the Drive API. Go to APIs & Services → Library, search for Google Drive API, open it, and choose Enable.
3. Configure the consent screen. Go to APIs & Services → OAuth consent screen. Choose the user type (External unless this is a Google Workspace-internal app), then set the app name, support email, and developer contact. While the app is in Testing, add the Google accounts that will connect as Test users.
4. Create OAuth credentials. Go to APIs & Services → Credentials → Create credentials → OAuth client ID, choose application type Web application, and give it a name. On save, Google shows a Client ID and Client secret; copy both now, as the secret is only shown here.
5. Add the redirect URL. On the same client, under Authorized redirect URIs, add the callback URL metamorphOS gives you in the connect flow. It must match exactly.

Connect in metamorphOS

Activate the Google Drive connector from the marketplace and add an account. Enter the Client ID and Client secret from the step above, then start the connect flow: metamorphOS sends you to Google to sign in and approve access, and Google returns you to metamorphOS once you consent. You can disconnect an account at any time to revoke access.

Good to know

• This connector uses Google’s app-scoped Drive access, so it can only see files it creates or files you explicitly open with it. It cannot list or touch your other, pre-existing Drive content.
• Permanently deleting a file or folder bypasses the trash and cannot be undone.
• Sharing, moving, and copying beyond app-created content, along with Google Docs and Sheets conversion, revisions, comments, and shared-drive administration, are outside this connector’s scope.