gwf-mcp

Same package for Windows and Mac. Use the install + path style for each OS.

Install

Windows

pip install -U gwf-mcp

Mac (Homebrew Python)

brew install pipx
pipx ensurepath
pipx install gwf-mcp
# upgrade: pipx upgrade gwf-mcp

Or Mac venv:

python3 -m venv ~/gwf-mcp-venv
source ~/gwf-mcp-venv/bin/activate
pip install -U gwf-mcp

Claude Desktop config

Windows

{
  "mcpServers": {
    "gwf-workspace": {
      "command": "python",
      "args": ["-m", "gwf_mcp"],
      "env": {
        "GWF_WORKSPACE_ROOT": "C:\\Users\\You\\Desktop\\accounting"
      }
    }
  }
}

Mac

{
  "mcpServers": {
    "gwf-workspace": {
      "command": "gwf-mcp",
      "args": [],
      "env": {
        "GWF_WORKSPACE_ROOT": "/Users/You/Desktop/accounting"
      }
    }
  }
}

Mac venv alternative: command = /Users/You/gwf-mcp-venv/bin/python, args = ["-m", "gwf_mcp"].

Quit Claude fully → reopen after config changes.

Usage (both OS)

• list_files → list (including nested folders)
• list_files(read="file.docx") → read
• get_workspace → show configured folder

Mac “no files” (most common)

Terminal ls shows files, but Claude says empty — macOS privacy.

Claude is blocked from Desktop/Documents; it gets an empty list with no error.

1. System Settings → Privacy & Security → Full Disk Access → enable Claude
2. Also check Files and Folders → Claude → Desktop Folder (on)
3. Fully quit Claude (Cmd+Q) → reopen
4. Config:

   "command": "/Users/YOUR_USER/.local/bin/gwf-mcp",
   "env": { "GWF_WORKSPACE_ROOT": "/Users/YOUR_USER/Desktop/accounting" }
   

5. Test without Claude:

   export GWF_WORKSPACE_ROOT="/Users/YOUR_USER/Desktop/accounting"
   gwf-mcp --self-test