list_directory

Retrieve detailed directory and file listings from a specified path, with options to include hidden files, apply filtering patterns, and choose output format (text or JSON).

Instructions

Get a detailed listing of files and directories in a path.

Args:
    path: Path to the directory
    include_hidden: Whether to include hidden files (starting with .)
    pattern: Optional glob pattern to filter entries
    format: Output format ('text' or 'json')
    ctx: MCP context

Returns:
    Formatted directory listing

Input Schema

Name	Required	Default
`format`	No	text
`include_hidden`	No
`path`	Yes
`pattern`	No

Input Schema (JSON Schema)

{
  "properties": {
    "format": {
      "default": "text",
      "title": "Format",
      "type": "string"
    },
    "include_hidden": {
      "default": false,
      "title": "Include Hidden",
      "type": "boolean"
    },
    "path": {
      "title": "Path",
      "type": "string"
    },
    "pattern": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Pattern"
    }
  },
  "required": [
    "path"
  ],
  "title": "list_directoryArguments",
  "type": "object"
}

MCP Filesystem Server

list_directory

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Filesystem Server

Related Tools

MCP directory API