list_dir

Scan and retrieve all non-gitignored files and directories in a specified path, optionally with recursion, returning structured JSON output. Part of the Serena MCP Server for enhanced codebase management.

Instructions

Lists all non-gitignored files and directories in the given directory (optionally with recursion). Returns a JSON object with the names of directories and files within the given directory.

Input Schema

Name	Required	Description
`max_answer_chars`	No	If the output is longer than this number of characters, no content will be returned. Don't adjust unless there is really no other way to get the content required for the task.
`recursive`	Yes	Whether to scan subdirectories recursively.
`relative_path`	Yes	The relative path to the directory to list; pass "." to scan the project root.

Input Schema (JSON Schema)

{
  "properties": {
    "max_answer_chars": {
      "default": 200000,
      "description": "If the output is longer than this number of characters,\nno content will be returned. Don't adjust unless there is really no other way to get the content\nrequired for the task.",
      "title": "Max Answer Chars",
      "type": "integer"
    },
    "recursive": {
      "description": "Whether to scan subdirectories recursively.",
      "title": "Recursive",
      "type": "boolean"
    },
    "relative_path": {
      "description": "The relative path to the directory to list; pass \".\" to scan the project root.",
      "title": "Relative Path",
      "type": "string"
    }
  },
  "required": [
    "relative_path",
    "recursive"
  ],
  "title": "applyArguments",
  "type": "object"
}

Serena MCP Server

list_dir

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Serena MCP Server

Related Tools

MCP directory API