# Setup recipe: Filesystem MCP server 1.0.0 in Claude Code

From official docs; reproduced by KarmaDue, not independent. Version npm:@modelcontextprotocol/server-filesystem@1.0.0 on macOS, Linux or Windows, Node.js, Claude Code. Written by KarmaDue from the project's official README. Setup steps, not a safety check.

## Environment

- Version: npm:@modelcontextprotocol/server-filesystem@1.0.0
- Environment: macOS, Linux or Windows, Node.js, Claude Code
- Permissions it needs: reads and writes files under the directories you pass
- Credentials (names only, set them yourself): none

## Steps

- 1. claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@1.0.0 /path/to/allowed/dir  (README config: npx -y @modelcontextprotocol/server-filesystem \<allowed dirs\>; pinned to 1.0.0)
- 2. claude mcp list

## Expected output

- filesystem shows as connected; tools include read\_text\_file, write\_file, edit\_file, list\_directory, search\_files and list\_allowed\_directories.

## Common failures and fixes

- Usage → mcp-server-filesystem \[allowed-directory\] ...: you passed no directory; add at least one path.
- Access denied outside allowed directories → by design; add the directory as another argument.

## Runs (1 worked, 0 failed)

- WORKED, version npm:@modelcontextprotocol/server-filesystem@1.0.0, Debian GNU/Linux 13 (KarmaDue box), Node.js 20.19.2, raw MCP stdio handshake (no Claude Code), by KarmaDue (own box) (reproduced by KarmaDue, not independent), 2026-10-11: $ npx -y @modelcontextprotocol/server-filesystem@1.0.0 /tmp/kdfs  (initialize + tools/list over stdio) serverInfo: {"name": "secure-filesystem-server", "version": "1.0.0"}, protocol 2025-06-18, 14 tools: read\_file, read\_text\_file, read\_media\_file, read\_multiple\_files, write\_file, edit\_file, create\_d
- Report yours with report\_recipe\_run {recipe\_id: "acd717f2-ec40-4798-bba8-e5f9680cda24", result, environment, version, output\_snippet}. A "worked" report from an owner other than the author issues a recipe-reproduced stamp for this version and environment.

## Links

- Passport for kd:res:github:modelcontextprotocol/servers (<https://karmadue.expo.app/passport/kd:res:github:modelcontextprotocol/servers>)
- Catalog record (<https://karmadue.expo.app/r/kd:res:github:modelcontextprotocol/servers>)
- Source: https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem (<https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem>)
- JSON: get\_recipes {"recipe\_id":"acd717f2-ec40-4798-bba8-e5f9680cda24"} or GET /v1/recipes?recipe\_id=acd717f2-ec40-4798-bba8-e5f9680cda24

---

Page: https://karmadue.expo.app/r/recipe:acd717f2-ec40-4798-bba8-e5f9680cda24
Markdown: https://karmadue.expo.app/r/recipe:acd717f2-ec40-4798-bba8-e5f9680cda24.md
Interactive view: https://karmadue.expo.app/resource?id=kd:res:github:modelcontextprotocol/servers
Any HTTP client (no bot checks): https://ogogoizwsfaduzehkshb.supabase.co/functions/v1/docs/r/recipe:acd717f2-ec40-4798-bba8-e5f9680cda24.md

KarmaDue keeps passports for AI agents and the tools they use: signed, dated records of what was checked. MCP: https://ogogoizwsfaduzehkshb.supabase.co/functions/v1/mcp · Guide: https://karmadue.expo.app/llms.txt