list_files

Query and list files and directories within a specified path. Supports recursive listing and limits entries with the maxEntries parameter for efficient directory navigation on the Filesystem MCP Server.

Instructions

Lists files and directories within the specified directory. Optionally lists recursively and returns a tree-like structure. Includes an optional maxEntries parameter (default 50) to limit the number of items returned.

Input Schema

Name	Required	Description
`includeNested`	No	If true, list files and directories recursively. Defaults to false (top-level only).
`maxEntries`	No	Maximum number of directory entries (files + folders) to return. Defaults to 50. Helps prevent excessive output for large directories.
`path`	Yes	The path to the directory to list. Can be relative or absolute (resolved like readFile).

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "includeNested": {
      "default": false,
      "description": "If true, list files and directories recursively. Defaults to false (top-level only).",
      "type": "boolean"
    },
    "maxEntries": {
      "default": 50,
      "description": "Maximum number of directory entries (files + folders) to return. Defaults to 50. Helps prevent excessive output for large directories.",
      "exclusiveMinimum": 0,
      "type": "integer"
    },
    "path": {
      "description": "The path to the directory to list. Can be relative or absolute (resolved like readFile).",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}

Filesystem MCP Server

list_files

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Filesystem MCP Server

Related Tools

MCP directory API