search_files

search_files

Search for terms in files using advanced query syntax, filtering by file type, properties, and directory to locate specific content quickly.

Instructions

Search for terms in files using KDE baloosearch.

Query Syntax Examples:

Simple search: "project plan"
Multiple terms: "budget AND marketing" (finds files with both terms)
OR search: "report OR presentation" (finds files with either term)
Phrase search: ""strategic plan"" (finds exact phrase)
Exclusion: "financial -tax" (finds files with "financial" but not "tax")
Wildcard: "report*" (finds files with words starting with "report")
Property search: "Artist:"Coldplay"" (finds audio files by artist)
File type search: "type:Audio" (finds audio files)
Combined expressions: "(type:Audio AND Artist:"Coldplay") OR (type:Document AND subject:"music")"

Input Schema

Name	Required	Description
`directory`	No	Limit search to specified directory (absolute path)
`limit`	No	Maximum number of results to return (default: 10)
`offset`	No	Offset from which to start the search (default: 0)
`query`	Yes	The search query terms. Supports advanced search syntax: - Basic search: Simple terms like "project plan" - AND queries: "budget AND marketing" (requires both terms) - OR queries: "report OR presentation" (requires either term) - NOT queries: "financial -tax" or "financial NOT tax" (excludes terms) - Phrase searches: "\"exact phrase\"" (matches exact phrases) - Wildcards: "report*" (matches partial words) - Property searches: "Artist:\"Coldplay\"" or "Author:\"Smith\"" - File type filters: "type:Audio", "type:Document", "type:Image", etc. - Grouping: Use parentheses "(term1 AND term2) OR term3" - Property comparisons: "rating>3", "modified>2024-01-01" Supported file types: - "Archive" (zip, tar, etc.) - "Folder" (directories) - "Audio" (mp3, wav, etc.) - "Video" (mp4, avi, etc.) - "Image" (jpg, png, etc.) - "Document" (pdf, doc, etc.) - "Spreadsheet" (xls, xlsx, etc.) - "Presentation" (ppt, pptx, etc.) - "Text" (txt, etc.) Common properties for all files: - filename (name of the file) - modified (last modification date) - mimetype (MIME type of file) - tags (user-defined tags) - rating (numeric rating 0-10) - userComment (user comments) Audio-specific properties: - Artist, Album, AlbumArtist, Composer, Lyricist - Genre, Duration, BitRate, Channels, SampleRate - TrackNumber, ReleaseYear, Comment Document-specific properties: - Author, Title, Subject, Keywords - PageCount, WordCount, LineCount - Language, Copyright, Publisher - CreationDate, Generator Media-specific properties (Video/Images): - Width, Height, AspectRatio, FrameRate Image-specific properties: - ImageMake, ImageModel, ImageDateTime - PhotoFlash, PhotoFNumber, PhotoISOSpeedRatings - PhotoGpsLatitude, PhotoGpsLongitude, PhotoGpsAltitude
`type`	No	Type of data to be searched. Common types include: - "Archive" (zip, tar, etc.) - "Folder" (directories) - "Audio" (mp3, wav, etc.) - "Video" (mp4, avi, etc.) - "Image" (jpg, png, etc.) - "Document" (pdf, doc, etc.) - "Spreadsheet" (xls, xlsx, etc.) - "Presentation" (ppt, pptx, etc.) - "Text" (txt, etc.) Note: This parameter is an alternative to using "type:" in the query.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "directory": {
      "description": "Limit search to specified directory (absolute path)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of results to return (default: 10)",
      "type": "number"
    },
    "offset": {
      "description": "Offset from which to start the search (default: 0)",
      "type": "number"
    },
    "query": {
      "description": "The search query terms. Supports advanced search syntax:\n- Basic search: Simple terms like \"project plan\"\n- AND queries: \"budget AND marketing\" (requires both terms)\n- OR queries: \"report OR presentation\" (requires either term)\n- NOT queries: \"financial -tax\" or \"financial NOT tax\" (excludes terms)\n- Phrase searches: \"\\\"exact phrase\\\"\" (matches exact phrases)\n- Wildcards: \"report*\" (matches partial words)\n- Property searches: \"Artist:\\\"Coldplay\\\"\" or \"Author:\\\"Smith\\\"\"\n- File type filters: \"type:Audio\", \"type:Document\", \"type:Image\", etc.\n- Grouping: Use parentheses \"(term1 AND term2) OR term3\"\n- Property comparisons: \"rating>3\", \"modified>2024-01-01\"\n\nSupported file types:\n- \"Archive\" (zip, tar, etc.)\n- \"Folder\" (directories)\n- \"Audio\" (mp3, wav, etc.)\n- \"Video\" (mp4, avi, etc.)\n- \"Image\" (jpg, png, etc.)\n- \"Document\" (pdf, doc, etc.)\n  - \"Spreadsheet\" (xls, xlsx, etc.)\n  - \"Presentation\" (ppt, pptx, etc.)\n- \"Text\" (txt, etc.)\n\nCommon properties for all files:\n- filename (name of the file)\n- modified (last modification date)\n- mimetype (MIME type of file)\n- tags (user-defined tags)\n- rating (numeric rating 0-10)\n- userComment (user comments)\n\nAudio-specific properties:\n- Artist, Album, AlbumArtist, Composer, Lyricist\n- Genre, Duration, BitRate, Channels, SampleRate\n- TrackNumber, ReleaseYear, Comment\n\nDocument-specific properties:\n- Author, Title, Subject, Keywords\n- PageCount, WordCount, LineCount\n- Language, Copyright, Publisher\n- CreationDate, Generator\n\nMedia-specific properties (Video/Images):\n- Width, Height, AspectRatio, FrameRate\n\nImage-specific properties:\n- ImageMake, ImageModel, ImageDateTime\n- PhotoFlash, PhotoFNumber, PhotoISOSpeedRatings\n- PhotoGpsLatitude, PhotoGpsLongitude, PhotoGpsAltitude",
      "type": "string"
    },
    "type": {
      "description": "Type of data to be searched. Common types include:\n- \"Archive\" (zip, tar, etc.)\n- \"Folder\" (directories)\n- \"Audio\" (mp3, wav, etc.)\n- \"Video\" (mp4, avi, etc.)\n- \"Image\" (jpg, png, etc.)\n- \"Document\" (pdf, doc, etc.)\n  - \"Spreadsheet\" (xls, xlsx, etc.)\n  - \"Presentation\" (ppt, pptx, etc.)\n- \"Text\" (txt, etc.)\nNote: This parameter is an alternative to using \"type:\" in the query.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Baloosearch MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Baloosearch MCP Server

Related Tools

MCP directory API