List Records
Query records from a NocoDB table with optional filtering and sorting.
Listing, counting and paging rules are written down in ${CLAUDE_PLUGIN_ROOT}/skills/record-management/SKILL.md; read it before the first step.
Arguments
Parse from "$ARGUMENTS":
table-name(required): Name or ID of the tablewhere-filter(optional): Filter in NocoDBwheresyntax, e.g.(Status,eq,Active)(translate it to the structuredfilterwhen it has dates or special characters)
Process
- Run
getTablesListto resolve the table name to an ID. - Run
getTableSchemato discover field names and types. - Run
queryRecordswith the table ID and the optional filter. If the user names an order, passsortas an array of objects:[{ "field": "Created", "direction": "desc" }](not"-Created").pageSizedefaults to 50 and is capped at 200. - Date comparisons need a sub-operator --
(Due,gte,exactDate,2026-06-01); ranges are two bounds, neverbtw. - Display results in a formatted table showing key fields.
- Report total count (
countRecordswith the same filter) and pagination info if more records exist.
Example Usage
/list-records Contacts
/list-records Orders (Status,eq,Pending)
/list-records Deals (Amount,gt,5000)~and(Stage,eq,Negotiation)