---

name: filesystem category: integration-connectivity/mcp-integrations version: 1.0.0 description: Complete guide to using Filesystem MCP server with Claude Code author: blackbox5/mcp verified: true tags: [mcp, filesystem, files, directories]

Filesystem MCP Server Skills

Configuration: Global access to /Users/shaansisodia Package: @modelcontextprotocol/server-filesystem

Security Note: The Filesystem MCP has access to your entire user directory. Claude will ask for confirmation before destructive operations (delete, overwrite, move).

For destructive operations, Claude will always ask for confirmation first. Use absolute paths for more reliable operations.

<available_skills> <skill_group name="File Reading"> Read the contents of a file Read package.json File path to read File contents, file metadata (size, type, permissions), encoding information Read specific lines from a file Show lines 10-20 of app.ts File path Starting line number (1-based) Ending line number (optional) Read multiple files at once Read all TypeScript files in src/ Array of file paths </skill_group>

<skill_group name="File Writing"> Write content to a file (creates or overwrites) Write 'Hello World' to test.txt File path File content Will overwrite existing files - Claude will ask for confirmation Append content to an existing file Append log entry to file.log File path Content to append </skill_group>

<skill_group name="File Management"> Create a new directory Create directory src/components/new Directory path Create parent directories (default: true) Delete a file Delete test-file.txt File path Requires confirmation before deletion Delete a directory and its contents Delete directory old-folder Directory path Delete all contents (default: true) Destructive operation - requires confirmation Move or rename a file Move file to new location Source path Destination path Copy a file Copy file to backup location Source path Destination path </skill_group>

<skill_group name="File Search"> Search for files by name or pattern Find all .ts files File name pattern Directory to search (default: current directory) Patterns to exclude Search for text within files Search for 'TODO' in all files Text to search for Directory to search File type filter (optional) Patterns to exclude Find files with specific extension Find all .json files File extension (e.g., 'ts', 'json', 'md') Directory to search </skill_group>

<skill_group name="Directory Operations"> List contents of a directory List files in src/ Directory path Files and subdirectories, file sizes, file types, modification dates Get tree structure of a directory Show directory tree of src/ Directory path Maximum depth (default: unlimited) Get information about a directory Get directory size Directory path Total size, file count, directory count, permissions </skill_group>

<skill_group name="File Information"> Get metadata about a file Get file info for package.json File path File size, creation date, modification date, file type, permissions, owner Check if a file exists Check if config.json exists File path Boolean (true/false) Check if a directory exists Check if node_modules exists Directory path </skill_group>

<skill_group name="Permission Management"> Get file or directory permissions Get permissions for script.sh File path Octal permissions (e.g., 755), symbolic permissions (e.g., rwxr-xr-x), owner, group, others Set file or directory permissions Make script executable File path Octal permissions (e.g., 755, 644) </skill_group>

<skill_group name="File Comparison"> Compare two files Compare file1.ts and file2.ts First file Second file Are identical (true/false), differences (if any), line-by-line comparison Get hash of file content Get MD5 hash of file File path Hash algorithm (md5, sha1, sha256) </skill_group> </available_skills>

<best_practices> Use absolute paths Check file existence before operations Backup important files Use descriptive file names Organize files logically Set appropriate permissions Clean up temporary files Delete without confirmation Overwrite without backup Use wildcard delete carelessly Ignore file permissions Create deep nesting Hardcode paths in code Forget to clean up </best_practices>

<error_handling> Permission denied Check file permissions Verify you own the file Use sudo with caution Check parent directory permissions File not found Verify file path is correct Use absolute path Check file actually exists Check for typos Cannot delete file Check if file is in use Verify permissions Close file handles Check if file is locked Disk full Check available space Clean up temporary files Remove old backups Clear cache files </error_handling>

<output_format> File Contents Raw file content as string with metadata Directory Listing Array of files with metadata (name, size, type, modified date) Search Results Array of matching file paths with line numbers and context File Info Object with size, created, modified, type, permissions </output_format>

<integration_notes> The Filesystem MCP has access to your entire user directory. Claude will confirm destructive operations (delete, overwrite) before executing them. Read files: Up to available memory. Write files: Up to available disk space. For large files, use read_file_lines to process in chunks. Supported patterns: .ts (all TypeScript files), src/**/.ts (all .ts files in src/), **/.json (all JSON files anywhere). Exclusions: /node_modules/, **/.test.js </integration_notes>