list_files
Browse file metadata with filters by project, tag, favorite, folder, or untagged, and paginate results to estimate token counts before reading file contents.
Instructions
List file metadata with optional filters (project_id, tag, favorite, folder, untagged) and pagination. Read-only; no side effects, auth, or rate limits. Each row is annotated with tags, est_tokens, and size_bytes; the response includes total_est_tokens so you can budget before reading bodies. project_id: null returns ONLY Knowledge Base files; omit the field to span everything. Use to browse known structure; for keyword/content lookup use search; for a denser whole-vault dump use project_map.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | No | Filter by project ID. Pass null to list ONLY Knowledge Base files (project_id IS NULL). | |
| tag | No | Filter by tag name | |
| favorite | No | Filter by favorite status | |
| folder | No | Filter by folder path | |
| untagged | No | If true, return only files that have no tags. Useful for bulk-tagging workflows. | |
| limit | No | Maximum number of results | |
| offset | No | Offset for pagination |