search_items
Search Proton Pass items by title, apply filters for type, state, vault, and sort, and navigate paginated JSON results.
Instructions
Search items by title with MCP pagination support for JSON output.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_items"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| field | No | Field to search (currently title only) | title |
| match | No | Match strategy for the query | contains |
| query | Yes | Search query string | |
| cursor | No | Pagination cursor from a previous response's nextCursor | |
| sortBy | No | Sort items. Allowed values: alphabetic-asc, alphabetic-desc, created-asc, created-desc. | |
| shareId | No | Search this share by ID; omitting both selectors uses the CLI default vault | |
| pageSize | No | Number of items per page (1-250, default 100) | |
| vaultName | No | Search this vault by name; omitting both selectors uses the CLI default vault | |
| filterType | No | Filter items by type. Allowed values: note, login, alias, credit-card, identity, ssh-key, wifi, custom. | |
| filterState | No | Filter items by state. Allowed values: active, trashed. Use "active" to exclude trashed items. | |
| caseSensitive | No | Whether the search is case-sensitive |