Dropbox MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Dropbox: 32 typed functions through one MCP server. No Dropbox API key needed.

Functions
32
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Dropbox

An MCP server for Dropbox alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/dropbox
Every site

One MCP server for Dropbox and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 17
  • downloadFileDownloads a file from the caller's Dropbox and returns a Bowmark file URL for it.

    Arguments

    NameTypeRequired
    input{ path: string }Yes

    Returns DropboxDownload

    interface DropboxDownload {
      url: string;
      name: string;
      contentType: string;
      sizeBytes: number;
      file?: { id: string; name: string; contentType: string; bytes: number; url: string; expiresAt: string }; // the run's saved copy; absent on a run no account owns
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/downloadFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.downloadFile({ path: "/invoice.pdf" });
  • downloadSharedFileDownloads the file behind a shared link and returns a Bowmark file URL for it, with its name, size and content type.

    Arguments

    NameTypeRequired
    input{ url: string }Yes

    Returns DropboxDownload

    interface DropboxDownload {
      url: string;
      name: string;
      contentType: string;
      sizeBytes: number;
      file?: { id: string; name: string; contentType: string; bytes: number; url: string; expiresAt: string }; // the run's saved copy; absent on a run no account owns
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/downloadSharedFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.downloadSharedFile({});
  • getFileMetadataReads one file or folder in the caller's own Dropbox by path: kind, size, modified time, revision, content hash, whether it is downloadable, and…

    Arguments

    NameTypeRequired
    input{ path: string }Yes

    Returns DropboxFileMetadata

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }
    
    interface DropboxFileMetadata extends DropboxEntry { isDownloadable?: boolean; shared?: boolean; modifiedBy?: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/getFileMetadata

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.getFileMetadata({ path: "/invoice.pdf" });
  • getMyAccountReads the signed-in caller's account: name, email, profile photo, account type, and storage used against the quota.

    Arguments

    None.

    Returns DropboxAccount

    interface DropboxAccount {
      accountId: string;
      name: string;
      email: string;
      emailVerified: boolean;
      photoUrl?: string;
      accountType: string; // Dropbox's own tag: "basic" | "pro" | "business"
      country?: string;
      locale?: string;
      referralLink?: string;
      team?: string;
      usedBytes?: number;
      allocatedBytes?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/getMyAccount

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.getMyAccount();
  • getPlansLists Dropbox's plans as its own pricing page shows them.

    Arguments

    NameTypeRequired
    input{ plan?: string }No

    Returns DropboxPlans

    interface DropboxPlan {
      key: string; // "plus" | "standard" | "advanced", the site's own column key
      name: string;
      price: string; // as shown, e.g. "$15 / user / month"
      users?: string;
      storage?: string;
      features: Array<{ section: string; feature: string; value: string | boolean }>; // true/false = included or not
    }
    
    interface DropboxPlans { url: string; plans: DropboxPlan[] }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/getPlans

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.getPlans();
  • listDeletedFilesLists the caller's recently deleted files and folders that can still be restored.

    Arguments

    NameTypeRequired
    input{ path?: string }No

    Returns DropboxDeletedListing

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }
    
    interface DropboxDeletedListing { path: string; deleted: DropboxEntry[]; hasMore: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listDeletedFiles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listDeletedFiles();
  • listFileRequestsLists the caller's file requests, open and closed, with how many files each has received.

    Arguments

    None.

    Returns DropboxFileRequests

    interface DropboxFileRequest { id: string; url: string; title: string; destination?: string; isOpen: boolean; fileCount?: number; created?: string; deadline?: string; description?: string }
    
    interface DropboxFileRequests { requests: DropboxFileRequest[]; hasMore: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listFileRequests

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listFileRequests();
  • listFileVersionsLists the earlier versions of a file in the caller's Dropbox, with when and by whom each was saved.

    Arguments

    NameTypeRequired
    input{ path: string; limit?: number }Yes

    Returns DropboxFileVersions

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }
    
    interface DropboxFileVersions { path: string; isDeleted: boolean; serverDeleted?: string; versions: DropboxEntry[] }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listFileVersions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listFileVersions({ path: "/invoice.pdf" });
  • listFolderLists a folder in the caller's own Dropbox.

    Arguments

    NameTypeRequired
    input{ path?: string }No

    Returns DropboxFolderListing

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }
    
    interface DropboxFolderListing { path: string; entries: DropboxEntry[]; hasMore: boolean; cursor?: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listFolder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listFolder();
  • listRecentFilesLists the caller's most recently modified files, newest first, with how much of the Dropbox was read.

    Arguments

    NameTypeRequired
    input{ limit?: number }No

    Returns DropboxRecentFiles

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }
    
    interface DropboxRecentFiles { files: DropboxEntry[]; scanned: number; oldestScanned?: string; hasMore: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listRecentFiles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listRecentFiles();
  • listSharedFolderLists the files and sub-folders inside a shared folder link.

    Arguments

    NameTypeRequired
    input{ url: string; path?: string }Yes

    Returns DropboxSharedFolder

    interface DropboxFolderEntry {
      name: string;
      isDir: boolean;
      path: string; // relative to the folder's own root, e.g. "/all_ast/ast0/se00005.se1"
      url: string;
      sizeBytes?: number;
      modified?: string; // ISO; absent for a directory
      fileId?: string;
    }
    
    interface DropboxSharedFolder {
      url: string;
      path: string; // the sub-path listed, "" for the folder's own root
      entries: DropboxFolderEntry[];
      totalEntries: number;
      hasMore: boolean; // this one page did not carry every entry
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listSharedFolder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listSharedFolder({});
  • listSharedWithMeLists the files and folders other people have shared with the caller (dropbox.com/share).

    Arguments

    NameTypeRequired
    input{ kind?: "file" | "folder" }No

    Returns DropboxSharedWithMe

    interface DropboxSharedItem { kind: "file" | "folder"; name: string; id: string; accessType?: string; previewUrl?: string; path?: string; owners?: string[]; invited?: string }
    
    interface DropboxSharedWithMe { items: DropboxSharedItem[]; hasMore: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listSharedWithMe

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listSharedWithMe();
  • listSharingMembersLists who has access to a shared file or folder in the caller's Dropbox, and whether each can view or edit.

    Arguments

    NameTypeRequired
    input{ file?: string; sharedFolderId?: string }Yes

    Returns DropboxSharingMembers

    interface DropboxSharingMember { kind: "user" | "group" | "invitee"; accessType?: string; name?: string; email?: string; accountId?: string; groupId?: string; inherited?: boolean }
    
    interface DropboxSharingMembers { members: DropboxSharingMember[]; hasMore: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/listSharingMembers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.listSharingMembers({ file: "/invoice.pdf" });
  • readSharedFileReturns the text of a shared document (PDF, Word, slides, text) the way Dropbox's own previewer extracts it, so an agent can read a shared file…

    Arguments

    NameTypeRequired
    input{ url: string }Yes

    Returns DropboxSharedFileText

    interface DropboxSharedFileText {
      url: string;
      name: string;
      pageCount: number;
      pages: Array<{ page: number; text: string }>; // 1-based, lines top-down
      text: string; // every page, joined
      links: string[]; // hyperlinks in the document
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/readSharedFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.readSharedFile({});
  • searchFilesSearches the caller's Dropbox by file name and content, as the search box at the top of dropbox.com/home does, returning matching files and folders…

    Arguments

    NameTypeRequired
    input{ query: string; path?: string; limit?: number }Yes

    Returns DropboxSearchResult

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }
    
    interface DropboxSearchResult { query: string; matches: DropboxEntry[]; hasMore: boolean; cursor?: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/searchFiles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.searchFiles({ query: "invoice" });
Act 15
  • changeProfilePhotoSets the signed-in caller's Dropbox profile photo from base64 image bytes and returns its URL.

    Arguments

    NameTypeRequired
    input{ base64: string }Yes

    Returns DropboxProfilePhoto

    interface DropboxProfilePhoto { photoUrl: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/changeProfilePhoto

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.changeProfilePhoto({});
  • closeFileRequestCloses one of the caller's file requests so it stops accepting uploads.

    Arguments

    NameTypeRequired
    input{ id: string }Yes

    Returns DropboxFileRequest

    interface DropboxFileRequest { id: string; url: string; title: string; destination?: string; isOpen: boolean; fileCount?: number; created?: string; deadline?: string; description?: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/closeFileRequest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.closeFileRequest({});
  • copyFileCopies a file or folder to another place in the caller's Dropbox.

    Arguments

    NameTypeRequired
    input{ from: string; to: string; autorename?: boolean }Yes

    Returns DropboxEntry

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/copyFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.copyFile({});
  • createFileRequestCreates a file request, a link anyone can upload files to, landing in a folder of the caller's Dropbox, with a title and optional deadline.

    Arguments

    NameTypeRequired
    input{ title: string; destination: string; deadline?: string; description?: string }Yes

    Returns DropboxFileRequest

    interface DropboxFileRequest { id: string; url: string; title: string; destination?: string; isOpen: boolean; fileCount?: number; created?: string; deadline?: string; description?: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/createFileRequest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.createFileRequest({});
  • createFolderCreates a new folder in the caller's Dropbox.

    Arguments

    NameTypeRequired
    input{ path: string; autorename?: boolean }Yes

    Returns DropboxEntry

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/createFolder

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.createFolder({});
  • deleteFileDeletes a file or folder in the caller's Dropbox (it goes to Deleted files, where restoreFile can bring it back).

    Arguments

    NameTypeRequired
    input{ path: string }Yes

    Returns DropboxEntry

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/deleteFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.deleteFile({});
  • moveFileMoves or renames a file or folder in the caller's Dropbox.

    Arguments

    NameTypeRequired
    input{ from: string; to: string; autorename?: boolean }Yes

    Returns DropboxEntry

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/moveFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.moveFile({});
  • removeSharingMemberRemoves a person's access to a shared file or folder in the caller's Dropbox.

    Arguments

    NameTypeRequired
    input{ file?: string; sharedFolderId?: string; member: string }Yes

    Returns DropboxSharingChange

    interface DropboxSharingChange { target: string; members: string[]; done: true; results?: Array<{ member: string; ok: boolean; error?: string }> }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/removeSharingMember

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.removeSharingMember({});
  • restoreFileRestores a deleted file or folder in the caller's Dropbox.

    Arguments

    NameTypeRequired
    input{ path: string; rev?: string }Yes

    Returns DropboxEntry

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/restoreFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.restoreFile({});
  • restoreFileVersionRestores a file in the caller's Dropbox to one of its earlier versions.

    Arguments

    NameTypeRequired
    input{ path: string; rev: string }Yes

    Returns DropboxEntry

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/restoreFileVersion

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.restoreFileVersion({});
  • saveSharedLinkToDropboxSaves the file or folder behind a shared link into the caller's own Dropbox (the 'Save to Dropbox' / 'Add to my Dropbox' button on a shared link…

    Arguments

    NameTypeRequired
    input{ url: string; path: string }Yes

    Returns DropboxSaveResult

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }
    
    interface DropboxSaveResult { status: "complete" | "in_progress"; entry: DropboxEntry | null; jobId: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/saveSharedLinkToDropbox

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.saveSharedLinkToDropbox({});
  • shareWithPeopleInvites people by email to a file or folder in the caller's Dropbox, as viewers or editors, with an optional message.

    Arguments

    NameTypeRequired
    input{ file?: string; sharedFolderId?: string; members: string[]; access?: "viewer" | "editor"; message?: string }Yes

    Returns DropboxSharingChange

    interface DropboxSharingChange { target: string; members: string[]; done: true; results?: Array<{ member: string; ok: boolean; error?: string }> }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/shareWithPeople

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.shareWithPeople({});
  • uploadFileUploads a text file into the caller's Dropbox at a full path, as the Upload button on dropbox.com/home does.

    Arguments

    NameTypeRequired
    input{ path: string; content: string; overwrite?: boolean }Yes

    Returns DropboxEntry

    interface DropboxEntry {
      kind: "file" | "folder" | "deleted";
      name: string;
      path: string; // e.g. "/Homework/math/Prime_Numbers.txt", pass to the other file functions
      id?: string; // "id:…"
      sizeBytes?: number;
      modified?: string; // ISO
      rev?: string;
      contentHash?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/dropbox/uploadFile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.dropbox.uploadFile({});

Use it from code