Integration · Documents

Connect Claude & ChatGPT to Shade

Ask your AI to find footage in a Shade drive, summarize what was said in an interview, or put the best shots in a collection. It can search assets and folders, read asset details, AI tags, metadata, comments and transcripts, and ask questions about a video or audio transcript. It can also create folders and collections, move, copy and trash files, set metadata and create share links.

Connect Shade free

Free plan, no credit card. Takes about a minute.

Try asking

“Find drone shots of the harbor in our Marketing drive.”
The AI finds the drive and searches its assets for your query.
“What does the CEO say about pricing in interview_03.mp4?”
It asks a question about the asset's transcript and returns the answer.
“Show me the transcript of the podcast episode, split by speaker.”
It gets the transcript of the audio asset with each speaker's lines.

What your AI can do

Search and browse

List workspaces and drives, browse folders, search assets and folders, and find assets that look like a given one.

Assets and transcripts

Read asset details, AI tags, metadata and comments, get speaker-split transcripts and ask questions about a video or audio transcript.

Organize and share

Create folders and collections, move, copy and trash files, set metadata values and create public share links.

“Make a collection called Spring campaign with everything in /Shoots/Spring.”
It creates the collection in the drive and adds the assets under that folder.
“Set the Status field on this clip to Approved.”
It looks up the drive's metadata fields and sets the value on the asset.
“Create a download link for the /Deliverables/Final folder that expires Friday.”
It creates a share link for the folder with read and download access and that expiry date. Anyone with the link gets that access.

175 tools for Shade

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_assets_to_collectionChanges dataAdd assets to a collection by `collection_id`: pass `asset_ids`, or `directory_paths` to add everything under those folders.
add_directory_paths_to_a_collectionChanges dataCreate a new category for a category. Required: directory paths. Search categories first to avoid duplicates. API summary: Add directory paths to a collection.
archive_metadataVisible to othersArchive a metadata (metadata id). Has effects visible outside this system. API summary: Archive metadata attribute on a drive.
archive_userDeletesDisable a user (drive id). Destructive action; may require approval. API summary: Hides the given individuals by id.
ask_about_assetChanges dataAsk a question about a video or audio asset's transcript. Pass `asset_id`, `drive_id` and `request.message`; returns an AI answer.
attach_userVisible to othersAssign a user (drive id). Has effects visible outside this system. API summary: Assign a face to another individual.
copy_fileVisible to othersCopy a file or folder in a drive: `drive_id`, `source` path and `destination` path.
create_an_avatar_for_a_workspaceChanges dataUpload a user. API summary: Create an avatar for a workspace.
create_asset_custom_thumbnailChanges dataCreate a new custom thumbnail for a asset. API summary: Set Custom Thumbnail.
create_asset_messageChanges dataCreate a new message for a asset. Required: comment or url. API summary: Add a comment to an asset.
create_asset_stackChanges dataCreate a new stack for a asset. Required: target asset id or drive id. API summary: Add an asset to a stack.
create_asset_transcription_overrideChanges dataCreate a new transcription override for a asset. Required: drive id. API summary: Rerun transcription for an asset.
create_category_documentChanges dataCreate a new document for a category. Required: drive id, name, mime type, size or upload for. API summary: Start the upload process for a collection attachment.
create_chunkedChanges dataCreate a new chunked. Required: query or drive id. API summary: Chunk enabled version of search above.
create_collectionChanges dataCreate a collection in a drive: `drive_id`, `name` and optional `description`.
create_creditChanges dataCreate a new credit. API summary: Gets the of available credits on a workspace.
create_documentChanges dataCreate a new document. Required: drive id, name, mime type, size or comment id. API summary: Start the upload process for a comment attachment.
create_document_make_directories_files_directory_batch_postVisible to othersCreate a new document. Required: paths or drive id. Has effects visible outside this system. API summary: Ensure a list of directories exist at the given path, creating if needed.
create_document_move_batch_files_move_batch_postVisible to othersCreate a new document. Required: sources, destinations or drive id. Has effects visible outside this system. API summary: Move a batch of files or folders to a new location.
create_document_trash_batch_route_files_trash_batch_postVisible to othersCreate a new document. Required: paths or drive id. Has effects visible outside this system. API summary: Move a file or folder to the trash.
create_dynamic_viewChanges dataCreate a new dynamic view. Required: drive id or name. API summary: Add a dynamic view for a drive.
create_folderChanges dataCreate a folder at `path` in a drive (`drive_id`).
create_folder_templateChanges dataCreate a new folder template. Required: name, workspace id or root path. API summary: Create a folder template from an existing folder.
create_groupChanges dataCreate a new group. Required: workspace id, name or emails. API summary: Create New Group.
create_group_userChanges dataCreate a new user for a group. Required: emails. API summary: Add Users To Group.
create_invite_joinVisible to othersCreate a new join for a invite. Has effects visible outside this system. API summary: Accepts invitation.
create_messageChanges dataCreate a new message for a message. Required: drive id, content or url. API summary: Reply to a comment.
create_message_paste_asset_comments_assets_asset_id_comments_pasChanges dataCreate a new message. Required: source asset id or drive id. API summary: Paste comments from another asset.
create_metadata_optionChanges dataCreate a new option for a metadata. Required: option name or option color. API summary: Create a metadata attribute option on a drive.
create_orderChanges dataCreate a new order. Required: asset id or new order. API summary: Move an asset to a new position in the collection.
create_resetChanges dataCreate a new reset. Required: drive id. API summary: Reset personalized search rankings.
create_rootChanges dataCreate a new root. Required: paths or drive id. API summary: Add asset roots.
create_share_linkChanges dataCreate a public share link for a file or folder: `drive_id`, `path`, `name`, `allowed_actions` (e.g. read, download, comment) and `is_public_enabled`; optional `expiration_date`. Anyone with the link gets that access.
create_stackChanges dataCreate a new stack. Required: asset ids or drive id. API summary: Create a new stack from a list of assets.
create_userChanges dataCreate a new user. Required: face ids or individual name. API summary: Create an individual from faces.
create_user_documentChanges dataCreate a new document for a user. Required: path or invites. API summary: Shares a file (or folder) w user.
create_user_for_share_to_perform_actions_withChanges dataCreate a new user. Required: name or email. API summary: Create user for share to perform actions with.
create_user_metadataChanges dataCreate a new metadata for a user. Required: metadata. API summary: Add metadata attributes to a drive.
create_workspaceChanges dataCreate a new workspace. Required: name, description, team size analytics or team usage analytics. API summary: Creates a workspace.
create_workspace_driveChanges dataCreate a new drive for a workspace. Required: name, description, type or icon type. API summary: Creates a drive in a workspace.
create_workspace_leaveChanges dataCreate a new leave for a workspace. API summary: Leave a workspace.
delete_asset_custom_thumbnailsMoves moneyPermanently delete a custom thumbnail by asset id. Financial or irreversible action; may require approval. API summary: Reset Custom Thumbnail.
delete_asset_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete a comment.
delete_asset_stacksMoves moneyPermanently delete a stack by asset id. Financial or irreversible action; may require approval. API summary: Remove an asset from its stack.
delete_categoriesMoves moneyPermanently delete a category by collection id. Financial or irreversible action; may require approval. API summary: Remove assets from a collection.
delete_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval. API summary: Delete a collection.
delete_documentsDeletesPermanently delete a document. Destructive action; may require approval. API summary: Delete a file or folder.
delete_dynamic_viewDeletesPermanently delete a dynamic view by dynamic view id. Destructive action; may require approval. API summary: Delete Dynamic View Route.
delete_facesMoves moneyPermanently delete a face by drive id. Financial or irreversible action; may require approval. API summary: Delete faces from an individual.
delete_files_or_folders_in_batchMoves moneyPermanently delete a document. Financial or irreversible action; may require approval. API summary: Delete files or folders in batch.
delete_folder_templateDeletesPermanently delete a folder template by template id. Destructive action; may require approval.
delete_groupDeletesPermanently delete a group by group id. Destructive action; may require approval. API summary: Delete Existing Group.
delete_group_usersMoves moneyPermanently delete a user by group id. Financial or irreversible action; may require approval. API summary: Remove Users From Group.
delete_rootDeletesPermanently delete a root by root id. Destructive action; may require approval. API summary: Remove an asset root.
delete_shared_usersMoves moneyPermanently delete a user by user id. Financial or irreversible action; may require approval. API summary: Removes a share from a path.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete a drive by driveid.
delete_user_public_file_shareDeletesPermanently delete a public file share by share id. Destructive action; may require approval. API summary: Delete a public share for a specific file or folder.
delete_user_remove_user_from_drive_workspaces_drives_drive_id_usDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Removes a user from a drive.
delete_workspaceDeletesPermanently delete a workspace by workspace id. Destructive action; may require approval. API summary: Deletes a workspace.
delete_workspace_userDeletesPermanently delete a user by user id to remove. Destructive action; may require approval. API summary: Removes a user from a workspace.
download_assetDownload the document for a asset. API summary: Get a signed download URL for an asset's data.
export_exportsChanges dataExport exports. API summary: Export search results.
export_messagesExport messages. API summary: Export comments in various formats.
get_all_files_shared_with_a_userList users for a user. API summary: Get all files shared with a user.
get_an_mrss_feed_for_a_collectionList categories for a category. Results are paginated. API summary: Get an MRSS feed for a collection.
get_appGet one app by version. API summary: Get the latest version of the app as a download url 307.
get_assetGet one asset's details by `asset_id` and `drive_id` (name, type, size, AI tags).
get_asset_metadataGet an asset's metadata values by `asset_id` and `drive_id`.
get_asset_transcriptGet the transcript of a video or audio asset, split by speaker, by `asset_id` and `drive_id`.
get_collectionGet one collection by `collection_id`.
get_current_userGet the Shade user this connection is signed in as.
get_dynamic_view_exportGet one export for a dynamic view by export format. API summary: Export dynamic view data.
get_groupGet one group by group id. API summary: Read Group.
get_inviteGet one invite by invite id. API summary: Gets data for a specific invitation.
get_job_statusGet one job status by drive id. API summary: Check indexing job status for a drive.
get_path_detailsGet details of a file or folder at `path` in a drive (`drive_id`).
get_proxyGet one proxy by proxy id. API summary: Get a proxy by id by redirecting to the signed url.
get_ranking_statusChanges dataGet the current status of a ranking. API summary: Track a search result selection for personalized ranking.
get_share_dataGet one user by user id. API summary: Get share data.
get_stackGet one stack by stack id. API summary: Get all assets for a stack.
get_urlGet one url by preview id. API summary: Get a preview by its id. Returns as a redirect to the signed url.
get_userGet one user by user id. API summary: Get an individual.
get_user_cloud_authorize_drive_workspaces_authorize_drives_driveGet one user by action. API summary: Authorize drive usage.
get_user_countGet one user by workspace id. API summary: Lists count of all the users for a specific workspace.
get_user_get_workspace_drive_workspaces_drives_drive_id_getGet one user by user id. API summary: Gets a drive from the driveid.
get_user_list_user_path_access_on_drive_workspaces_drives_drive_Get one user for a user by user id. API summary: Lists all the paths for a user in a specific drive.
get_workspaceGet one workspace by workspace id. API summary: Gets a workspace from the workspaceid.
get_workspace_userGet one user for a workspace by user id. API summary: Lists all the paths for a user in a specific workspace.
list_asset_clipsList clips for a asset. Optional filters: drive id, start time or end time. API summary: Clip a video between two timestamps (hybrid head re-encode + tail copy).
list_asset_commentsList the comments on an asset by `asset_id`.
list_asset_facesList faces for a asset. Optional filters: drive id. API summary: Get all the faces for an asset.
list_asset_previewsList previews for a asset. Optional filters: drive id. API summary: Get all preview images for an asset with signed urls.
list_asset_usersList users for a asset. Optional filters: drive id. API summary: Get all mentionable users on comments for an asset.
list_auth_tokensList auth tokens. API summary: Generate custom token for user auth.
list_collection_foldersList the folder paths included in a collection by `collection_id`, optionally filtered by `query`.
list_collectionsList the collections in a drive by `drive_id`.
list_documentsList documents. Optional filters: drive id, type or authorization. API summary: Export the transcription as a file for an asset if it exists.
list_documents_exists_files_exists_getList documents. Optional filters: path or drive id. API summary: Retrieve if a path exists or not on filesystem.
list_drive_templatesList drive templates. API summary: Get all public drive templates.
list_drivesList the drives in a workspace by `workspace_id`. Most other tools need a `drive_id`.
list_dynamic_viewsList dynamic views. Optional filters: drive id. API summary: Get the dynamic views for a drive.
list_face_assetsList assets for a face. API summary: Get the asset a face is for.
list_face_individualsList individuals for a face. API summary: Get the individual a face is for.
list_facesList faces. Optional filters: drive id. Results are paginated. API summary: List all unclustered faces.
list_folder_contentsChanges dataList the files and folders at a `path` in a drive (`drive_id`), optionally filtered by `query` or searched `recursive`ly. Paginated.
list_folder_templatesList folder templates. Optional filters: workspace id or drive id. API summary: List folder templates for a workspace.
list_groupsList groups. Optional filters: workspace id. API summary: Read Groups.
list_metadata_fieldsList the metadata fields (attributes) defined on a drive by `drive_id`, to use with update_asset_metadata.
list_pathsList paths. Optional filters: path or drive id. API summary: Get an asset from its path.
list_permissionsList permissions. API summary: Lists all the drives and your permission level for them.
list_rootsList roots. Optional filters: drive id. API summary: Get the asset roots.
list_segmentsList segments. Optional filters: drive id. API summary: Get the transcription segments for an asset if it exists.
list_shade_fs_public_keysList shade fs public keys. API summary: Get the FS public key to sign files.
list_share_linksList public share links for a `path` in a drive (`drive_id`).
list_storage_providersList storage providers. API summary: Retrieve the storage provider for the files.
list_suggestionsList suggestions. Optional filters: drive id. API summary: Get AI-generated conversation starters for the transcript.
list_usagesList usages. Optional filters: drive id. API summary: Get the usage of a drive's assets for analytics.
list_user_drive_shared_linksList drive shared links for a user. API summary: Get all the shared links from a drive.
list_user_facesList faces for a user. API summary: List all faces for an individual.
list_user_file_permissionsList file permissions for a user. Optional filters: asset id. API summary: Get your role + actions you can do on an asset.
list_user_folder_permissionsList folder permissions for a user. Optional filters: path. API summary: Get your role + actions you can do on a folder (or file if you pass a path).
list_user_identifiersList identifiers for a user. API summary: Gets a driveid from an identifier.
list_user_messagesList messages for a user. Optional filters: share id. API summary: Get a signed JWT for Shade Message Bus for a specific drive.
list_user_shade_fs_tokensList shade fs tokens for a user. Optional filters: machine id or share id. API summary: Get a signed JWT for a specific drive.
list_usersList users. Optional filters: drive id or labeled. Results are paginated. API summary: List all individuals.
list_users_list_all_user_drives_workspaces_drive_ids_getList users. API summary: Lists all user drives (including demo workspace drives).
list_users_list_drive_users_workspaces_drives_drive_id_users_getList users for a user. API summary: Lists all the user for a specific drive.
list_users_list_path_users_workspaces_drives_drive_id_file_usersList users for a user. Optional filters: path. API summary: Lists all the user for a specific path (file or folder).
list_users_list_user_path_access_drives_workspaces_drives_drive_List users for a user. API summary: Lists all the paths for a specific workspace.
list_workspace_domainsList domains for a workspace. API summary: Gets a workspace for workspace domain.
list_workspace_usersList users for a workspace. API summary: Lists all the paths for a specific workspace.
list_workspace_users_list_workspace_users_workspaces_workspace_iList users for a workspace. API summary: Lists all the users for a specific workspace.
list_workspace_webhook_dashboard_urlsList webhook dashboard urls for a workspace. API summary: Get Svix webhook dashboard URL for workspace.
list_workspace_zapier_integration_keysList zapier integration keys for a workspace. API summary: Get Svix webhook zapier integration key for workspace.
list_workspacesList the workspaces you belong to. Use a workspace ID to list its drives.
move_fileChanges dataMove or rename a file or folder in a drive: `drive_id`, `source` path and `destination` path.
pay_userMoves moneyPay a user (new owner user id). Financial or irreversible action; may require approval. API summary: Transfer a workspace to a new owner.
quick_searchChanges dataSearch a drive for anything matching `query` (assets, folders, people and more) by `drive_id`. Optional `entity_types`, `limit` and `offset`.
remove_directory_paths_from_a_collectionMoves moneyPermanently delete a category by collection id. Financial or irreversible action; may require approval. API summary: Remove directory paths from a collection.
search_asset_sourcesSearch sources for a asset by drive id, name, authorization or shade collection id. Use this to find existing sources before creating a new source. API summary: Get an asset source by redirecting to the signed url.
search_assetsChanges dataSearch media assets in a drive by `drive_id` with an optional `query`, `filters`, `collection_id`, `sort` or `similar_asset_id` (find look-alikes). Paginated.
search_foldersFind folders under a `path` in a drive (`drive_id`) matching `query`. Paginated.
search_recentsSearch recents by drive id. Use this to find existing recents before creating a new recent. Results are paginated. API summary: Get recent unique search queries for the current user.
send_userVisible to othersEmail a user (share id). Has effects visible outside this system. API summary: Invite a user to a public share.
send_user_invitesVisible to othersSend a user (drive id). Has effects visible outside this system. API summary: Sends invites for user to join a drive.
send_workspace_invitesVisible to othersSend a workspace (workspace id). Has effects visible outside this system. API summary: Sends invites for user to join a workspace.
submit_userDeletesMerge a user (drive id). Destructive action; may require approval. API summary: Merges individuals together into one.
submit_user_completeVisible to othersComplete a user. Has effects visible outside this system. API summary: Confirm uploading an avatar for a user.
submit_user_workspace_complete_avatar_workspaces_workspace_id_avVisible to othersComplete a user (workspace id). Has effects visible outside this system. API summary: Confirm uploading an avatar for a workspace.
trash_fileChanges dataMove a file or folder at `path` in a drive (`drive_id`) to the trash.
update_asset_messageChanges dataUpdate an existing message identified by message id. API summary: Update a comment.
update_asset_metadataVisible to othersSet one metadata value on an asset: `asset_id`, `drive_id`, `metadata_attribute_id` and `metadata_attribute_value` (leave the value out to clear it).
update_category_documentChanges dataUpdate an existing document identified by document id. API summary: Mark the upload of a collection attachment as complete.
update_collectionChanges dataUpdate a collection by `collection_id`: name, description or public sharing settings.
update_documentChanges dataUpdate an existing document identified by document id. API summary: Mark the upload of a comment attachment as complete.
update_documentsVisible to othersUpdate an existing document identified by asset id. Has effects visible outside this system. API summary: Move an asset to a new position within its stack.
update_dynamic_viewChanges dataUpdate an existing dynamic view identified by dynamic view id. API summary: Update a dynamic view for a drive.
update_folder_templateChanges dataUpdate an existing folder template identified by template id. Only the fields you pass are changed. API summary: Update a folder template.
update_groupChanges dataUpdate an existing group identified by group id. API summary: Update Existing Group.
update_messagesVisible to othersUpdate an existing message identified by comment id. Has effects visible outside this system. API summary: Update a comment to be resolved or not.
update_messages_react_to_comment_handler_assets_asset_id_commentVisible to othersUpdate an existing message identified by comment id. Has effects visible outside this system. API summary: React to a comment.
update_userChanges dataUpdate an existing user identified by user id. API summary: Update an individual.
update_user_metadataChanges dataUpdate an existing metadata identified by metadata id. API summary: Update a metadata attribute on a drive.
update_user_public_file_shareChanges dataUpdate an existing public file share identified by share id. API summary: Update a public share for a specific file or folder.
update_user_settingsVisible to othersUpdate an existing setting identified by drive id. Has effects visible outside this system. API summary: Update drive settings.
update_user_update_drive_permissions_workspaces_drives_drive_id_DeletesUpdate an existing user identified by user id. Destructive action; may require approval. API summary: Updates people's permissions on a drive.
update_user_update_drive_workspaces_drives_drive_id_putChanges dataUpdate an existing user identified by user id. API summary: Updates drive.
update_usersVisible to othersUpdate an existing user. Has effects visible outside this system. API summary: Modify user data.
update_users_update_path_permissions_workspaces_drives_drive_id_Moves moneyUpdate an existing user identified by user id. Financial or irreversible action; may require approval. API summary: Updates people's permissions on a path.
update_valuesVisible to othersUpdate an existing value. Has effects visible outside this system. API summary: Bulk update asset metadata attributes.
update_workspaceChanges dataUpdate an existing workspace identified by workspace id. API summary: Updates a workspace.
update_workspace_settingsVisible to othersUpdate an existing setting identified by workspace id. Has effects visible outside this system. API summary: Update workspace settings.
update_workspace_userDeletesUpdate an existing user identified by user id. Destructive action; may require approval. API summary: Updates people's permissions on a workspace.
upload_documentChanges dataUpload a document. API summary: Initiate attachment upload.
upload_user_urlChanges dataUpload a user. API summary: Create an avatar for a user.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Shade from the app list.
2
Paste your key
Paste a Shade API key (it starts with sk_). In the Shade app click settings at the top left, choose API keys under My account and click Generate new key. Give it a name and an optional expiry, then copy the key, as it is not shown again. The key has the same access as your account.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Shade?

The AI can list workspaces, drives, folders, collections and share links, search assets and folders, and read asset details, metadata, comments and transcripts. It can ask questions about a transcript, create folders and collections, add assets to collections, move, copy and trash files, set metadata values and create share links.

Does the AI see my Shade credentials?

No. Your Shade API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Trashing a file, moving files and creating a public share link change what is in your drive and who can see it, and these can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Shade account.

What access does the Shade API key give?

A Shade API key has the same access as the account that created it. The tools you switch on in HeyMyApps decide what the AI can do with that access. You can also set an expiry date when you generate the key.