Metadata-Version: 2.4
Name: gwf-mcp
Version: 1.1.9
Summary: GWF Workspace MCP server for Claude Desktop — folder-scoped document tools
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.9.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: pdfplumber>=0.11.0
Requires-Dist: python-docx>=1.1.2
Requires-Dist: pypdf>=5.0.0
Requires-Dist: pymupdf>=1.24.0
Requires-Dist: python-pptx>=1.0.0

# gwf-mcp

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

## Install

### Windows
```bash
pip install -U gwf-mcp
```

### Mac (Homebrew Python)
```bash
brew install pipx
pipx ensurepath
pipx install gwf-mcp
# upgrade: pipx upgrade gwf-mcp
```

Or Mac venv:
```bash
python3 -m venv ~/gwf-mcp-venv
source ~/gwf-mcp-venv/bin/activate
pip install -U gwf-mcp
```

## Claude Desktop config

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

### Mac
```json
{
  "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:
   ```json
   "command": "/Users/YOUR_USER/.local/bin/gwf-mcp",
   "env": { "GWF_WORKSPACE_ROOT": "/Users/YOUR_USER/Desktop/accounting" }
   ```
5. Test without Claude:
   ```bash
   export GWF_WORKSPACE_ROOT="/Users/YOUR_USER/Desktop/accounting"
   gwf-mcp --self-test
   ```
