gwf-mcp 1.1.4

GWF Workspace MCP server for Claude Desktop — folder-scoped document tools

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” checklist

1. Path is Mac style (/Users/...), not C:\\...
2. Folder exists and has pdf/docx/xlsx/pptx
3. Full Disk Access for Claude (System Settings → Privacy & Security)
4. get_workspace then list_files