Does Filesystem (reference) work with Claude Code?

Q: Does Filesystem (reference) work with Claude Code?

Yes. In our test on 2026-10-13 (Claude Code 2.1.296 (Claude Code), plan: Claude Pro), Filesystem (reference) passed install, connect, tools and an agent task.

Yes. Filesystem (reference) passed every step of our test in Claude Code on Oct 13, 2026: it installed, connected, its tools were visible, and an agent used it to finish a real task.

Result

ResultPassed

Date testedOct 13, 2026

Plan tested onClaude Pro

App version2.1.296 (Claude Code)

Modelhaiku

Steps

install OK
connected OK
tools visible OK
agent task: write read back OKcreate a document with known content, then read it back

From our own harness run, not the maker’s claims. How we test.

What happened in this run

Install config we used

claude mcp add -s local ref-filesystem -- npx -y @modelcontextprotocol/server-filesystem /workspace/timmy/harness/sandbox/fsroot

Connection check

ref-filesystem: npx -y @modelcontextprotocol/server-filesystem /workspace/timmy/harness/sandbox/fsroot - ✔ Connected

Tools check

verified via task step: agent saw and called the server's tools

Agent task: write read back

Tool calls, in order: mcp__ref-filesystem__write_file, mcp__ref-filesystem__read_text_file

Raw details from our harness log for this run. Secrets redacted.

Set it up in Claude Code

Copy-paste config for every app is on the Filesystem (reference) page. Not connecting? Claude Code MCP troubleshooting.

Other apps we tested it in: Cursor (passed) · Claude Desktop (passed) · ChatGPT (Codex) (passed).

All MCP servers tested in Claude Code