1. Home
  2. MCP Filesystem Server
  3. MCP Filesystem Server for Cursor: Setup & Config

Data as of

MCP Filesystem Server for Cursor: Setup & Config

MCP Filesystem Server gives Cursor file and directory operations within explicitly allowed paths.

MCP Filesystem Server Cursor configuration

  1. Choose Cursor configuration scope

    For MCP Filesystem Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

  2. Add MCP Filesystem Server to Cursor

    Use the mcp-filesystem-server entry below in mcpServers. Keep MCP Filesystem Server's documented stdio connection fields and your other Cursor entries.

  3. Check MCP Filesystem Server in Cursor

    MCP Filesystem Server: Enable in Cursor’s MCP settings; inspect tools.

Config file · Project: .cursor/mcp.json

User: ~/.cursor/mcp.json

JSON
{
  "mcpServers": {
    "mcp-filesystem-server": {
      "command": "mcp-filesystem-server",
      "args": [
        "/path/to/allowed/directory",
        "/another/allowed/directory"
      ],
      "env": {}
    }
  }
}

MCP Filesystem in Cursor: stdio checks

  • Cursor must find mcp-filesystem-server for MCP Filesystem Server. Enable the project/user entry in MCP settings and inspect its tools.
  • MCP Filesystem Server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
Tools
read_file, read_multiple_files, write_file

MCP Filesystem Server — details. Cursor guide

Frequently asked questions

Cursor's MCP Filesystem Server entry belongs under mcpServers in .cursor/mcp.json (project) or ~/.cursor/mcp.json (user). Confirm the active scope in MCP settings.

Cursor's mcp-filesystem-server example uses stdio.

MCP Filesystem Server's Cursor configuration invokes mcp-filesystem-server.

MCP Filesystem Server's stored list contains 14 tools, including read_file, read_multiple_files, write_file. Compare those names with Cursor's connected tool list; the stored list is not a live check.