`dropbox_search`

Pack: dropbox · Endpoint: https://gateway.pipeworx.io/dropbox/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/dropbox_search for the schema, then POST the same URL with its arguments for the data.

Search Dropbox for files and folders by name or content. Returns matching paths, file types, and metadata. Use when you need to find a file without knowing its exact location.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query string
`max_results`	number	no	Maximum results to return (default 20)

Example call

Arguments

{
  "query": "invoice"
}

curl

curl -X POST https://gateway.pipeworx.io/dropbox/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"dropbox_search","arguments":{"query":"invoice"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('dropbox_search', {
  "query": "invoice"
});

More examples

{
  "query": "Q4 report",
  "max_results": 10
}

Response shape

Field	Type	Description
`matches`	array	Array of matching files and folders
`cursor`	string	Pagination cursor
`has_more`	boolean	Whether more results exist
`error`	string	Error code if connection failed
`message`	string	Error message if connection failed

Full JSON Schema

{
  "type": "object",
  "properties": {
    "matches": {
      "type": "array",
      "description": "Array of matching files and folders",
      "items": {
        "type": "object",
        "properties": {
          "metadata": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "File or folder name"
              },
              "path_display": {
                "type": "string",
                "description": "Display path"
              },
              "id": {
                "type": "string",
                "description": "Unique ID"
              },
              "size": {
                "type": "number",
                "description": "File size in bytes"
              },
              "modified": {
                "type": "string",
                "description": "Last modified timestamp"
              }
            }
          },
          "match_type": {
            "type": "string",
            "description": "Type of match (e.g., filename)"
          }
        }
      }
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor"
    },
    "has_more": {
      "type": "boolean",
      "description": "Whether more results exist"
    },
    "error": {
      "type": "string",
      "description": "Error code if connection failed"
    },
    "message": {
      "type": "string",
      "description": "Error message if connection failed"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "dropbox": {
      "url": "https://gateway.pipeworx.io/dropbox/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

dropbox_search