box__search

Access

Requires a project integration connection for box.

Call type: Can read or manage credentials.

Arguments

Field	Type	Required	Description and constraints
`query`	`string`	Yes	Search string to match against item names and content
`type`	`string`	No	Limit results to 'file', 'folder', or '`web_link`'
`ancestor_folder_ids`	`string`	No	Comma-separated folder IDs to scope the search to
`limit`	`number`	No	Maximum results to return (max 200)
`offset`	`number`	No	Number of results to skip for pagination

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "box__search",
    "arguments": {
      "query": "example"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the box integration reference for provider setup and tool context.

Full schemas

json

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search string to match against item names and content"
    },
    "type": {
      "type": "string",
      "description": "Limit results to 'file', 'folder', or 'web_link'"
    },
    "ancestor_folder_ids": {
      "type": "string",
      "description": "Comma-separated folder IDs to scope the search to"
    },
    "limit": {
      "type": "number",
      "description": "Maximum results to return (max 200)"
    },
    "offset": {
      "type": "number",
      "description": "Number of results to skip for pagination"
    }
  },
  "required": [
    "query"
  ],
  "description": "Arguments for the box__search tool."
}