search_notes_advanced
Filter and sort notes by type, metadata, dates, or content to quickly find specific information. Use structured advanced search for precise, organized results.
Instructions
Advanced search with structured filters for metadata, dates, and content
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content_contains | No | Search within note content | |
| created_before | No | Find notes created before time period | |
| created_within | No | Find notes created within time period | |
| fields | No | Optional array of field names to include in response. Supports dot notation for nested fields (e.g. "metadata.tags") and wildcard patterns (e.g. "metadata.*"). If not specified, all fields are returned. | |
| limit | No | Maximum number of results | |
| metadata_filters | No | Array of metadata filters | |
| offset | No | Number of results to skip | |
| sort | No | Sort order for results | |
| type | No | Filter by note type | |
| updated_before | No | Find notes updated before time period (e.g., "7d", "1w", "2m") | |
| updated_within | No | Find notes updated within time period (e.g., "7d", "1w", "2m") | |
| vault_id | No | Optional vault ID to operate on. If not provided, uses the current active vault. |
Input Schema (JSON Schema)
{
"properties": {
"content_contains": {
"description": "Search within note content",
"type": "string"
},
"created_before": {
"description": "Find notes created before time period",
"type": "string"
},
"created_within": {
"description": "Find notes created within time period",
"type": "string"
},
"fields": {
"description": "Optional array of field names to include in response. Supports dot notation for nested fields (e.g. \"metadata.tags\") and wildcard patterns (e.g. \"metadata.*\"). If not specified, all fields are returned.",
"items": {
"type": "string"
},
"type": "array"
},
"limit": {
"default": 50,
"description": "Maximum number of results",
"type": "number"
},
"metadata_filters": {
"description": "Array of metadata filters",
"items": {
"properties": {
"key": {
"description": "Metadata key to filter on",
"type": "string"
},
"operator": {
"default": "=",
"description": "Comparison operator",
"enum": [
"=",
"!=",
">",
"<",
">=",
"<=",
"LIKE",
"IN"
],
"type": "string"
},
"value": {
"description": "Value to match",
"type": "string"
}
},
"required": [
"key",
"value"
],
"type": "object"
},
"type": "array"
},
"offset": {
"default": 0,
"description": "Number of results to skip",
"type": "number"
},
"sort": {
"description": "Sort order for results",
"items": {
"properties": {
"field": {
"enum": [
"title",
"type",
"created",
"updated",
"size"
],
"type": "string"
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string"
}
},
"required": [
"field",
"order"
],
"type": "object"
},
"type": "array"
},
"type": {
"description": "Filter by note type",
"type": "string"
},
"updated_before": {
"description": "Find notes updated before time period (e.g., \"7d\", \"1w\", \"2m\")",
"type": "string"
},
"updated_within": {
"description": "Find notes updated within time period (e.g., \"7d\", \"1w\", \"2m\")",
"type": "string"
},
"vault_id": {
"description": "Optional vault ID to operate on. If not provided, uses the current active vault.",
"type": "string"
}
},
"required": [],
"type": "object"
}
Implementation Reference
- src/server/search-handlers.ts:54-73 (handler)The primary handler function for the 'search_notes_advanced' MCP tool. It validates input arguments, resolves the vault context, executes the advanced search via HybridSearchManager, applies optional field filtering, and returns the results as formatted JSON text content.handleSearchNotesAdvanced = async (args: SearchNotesAdvancedArgs) => { // Validate arguments validateToolArgs('search_notes_advanced', args); const { hybridSearchManager } = await this.resolveVaultContext(args.vault_id); const results = await hybridSearchManager.searchNotesAdvanced(args); // Apply field filtering if specified const filteredResults = filterSearchResults(results, args.fields); return { content: [ { type: 'text', text: JSON.stringify(filteredResults, null, 2) } ] }; };
- src/server.ts:1254-1257 (registration)Tool dispatch registration in the CallToolRequestSchema handler's switch statement, routing calls to the SearchHandlers.handleSearchNotesAdvanced method.case 'search_notes_advanced': return await this.searchHandlers.handleSearchNotesAdvanced( args as unknown as SearchNotesAdvancedArgs );
- src/server.ts:626-720 (schema)Tool schema definition including name, description, and detailed inputSchema advertised in the ListToolsRequestSchema response.name: 'search_notes_advanced', description: 'Advanced search with structured filters for metadata, dates, and content', inputSchema: { type: 'object', properties: { type: { type: 'string', description: 'Filter by note type' }, metadata_filters: { type: 'array', items: { type: 'object', properties: { key: { type: 'string', description: 'Metadata key to filter on' }, value: { type: 'string', description: 'Value to match' }, operator: { type: 'string', enum: ['=', '!=', '>', '<', '>=', '<=', 'LIKE', 'IN'], default: '=', description: 'Comparison operator' } }, required: ['key', 'value'] }, description: 'Array of metadata filters' }, updated_within: { type: 'string', description: 'Find notes updated within time period (e.g., "7d", "1w", "2m")' }, updated_before: { type: 'string', description: 'Find notes updated before time period (e.g., "7d", "1w", "2m")' }, created_within: { type: 'string', description: 'Find notes created within time period' }, created_before: { type: 'string', description: 'Find notes created before time period' }, content_contains: { type: 'string', description: 'Search within note content' }, sort: { type: 'array', items: { type: 'object', properties: { field: { type: 'string', enum: ['title', 'type', 'created', 'updated', 'size'] }, order: { type: 'string', enum: ['asc', 'desc'] } }, required: ['field', 'order'] }, description: 'Sort order for results' }, limit: { type: 'number', description: 'Maximum number of results', default: 50 }, offset: { type: 'number', description: 'Number of results to skip', default: 0 }, vault_id: { type: 'string', description: 'Optional vault ID to operate on. If not provided, uses the current active vault.' }, fields: { type: 'array', items: { type: 'string' }, description: 'Optional array of field names to include in response. Supports dot notation for nested fields (e.g. "metadata.tags") and wildcard patterns (e.g. "metadata.*"). If not specified, all fields are returned.' } }, required: [] } },
- src/server/types.ts:73-93 (schema)TypeScript interface defining the structure of arguments accepted by the search_notes_advanced tool handler.export interface SearchNotesAdvancedArgs { type?: string; metadata_filters?: Array<{ key: string; value: string; operator?: '=' | '!=' | '>' | '<' | '>=' | '<=' | 'LIKE' | 'IN'; }>; updated_within?: string; updated_before?: string; created_within?: string; created_before?: string; content_contains?: string; sort?: Array<{ field: 'title' | 'type' | 'created' | 'updated' | 'size'; order: 'asc' | 'desc'; }>; limit?: number; offset?: number; vault_id?: string; fields?: string[]; }
- src/server/search-handlers.ts:56-73 (helper)Call to validation utility that performs input validation specific to search_notes_advanced tool arguments.validateToolArgs('search_notes_advanced', args); const { hybridSearchManager } = await this.resolveVaultContext(args.vault_id); const results = await hybridSearchManager.searchNotesAdvanced(args); // Apply field filtering if specified const filteredResults = filterSearchResults(results, args.fields); return { content: [ { type: 'text', text: JSON.stringify(filteredResults, null, 2) } ] }; };