# Filesystem

> Use this tool when you need to securely interact with local filesystems, perform file operations like reading, writing, and managing directories, or require robust path resolution and error handling for AI workflows involving file manipulation or document analysis. It provides a standardized interface for AI agents to access filesystems while maintaining a clean separation between agents and the underlying system. The Filesystem tool is ideal for use cases like code generation, file editing, or data processing that demand secure and reliable file system interactions.

Canonical page: https://skillsregistry.net/skills/cyanheads-filesystem  
JSON: https://api.skillsregistry.net/v1/skills/cyanheads-filesystem

## Description

Filesystem MCP Server provides a secure interface for AI agents to interact with local filesystems through standardized tools. Developed by Casey Hand (@cyanheads), this TypeScript implementation offers essential file operations including reading, writing, updating, and managing directories with robust path resolution, error handling, and logging. The server maintains session state for relative path resolution and implements comprehensive security measures like path sanitization and validation. It's particularly useful for AI workflows requiring file manipulation, code generation, or document analysis while maintaining a clean separation between AI agents and the underlying filesystem.

## Trust

- **Trust score (0–1):** 0.81
- **Verification tier:** verified
- **Last scanned:** 2026-09-19

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** ai-ml
- **Updated:** 2026-09-19

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/cyanheads-filesystem)
- **Repository:** <https://github.com/cyanheads/filesystem-mcp-server>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "cyanheads-filesystem"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/cyanheads-filesystem` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/cyanheads-filesystem/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt