Metadata-Version: 2.4
Name: gwf-mcp
Version: 1.1.1
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

Installable MCP server for Claude Desktop. Other developers do **not** need the GWF app codebase.

## Install

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

## Claude Desktop config

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

Quit Claude and reopen.

## One documents tool: `list_files`

| Ask | Call |
|-----|------|
| List files | `list_files()` |
| Read a file | `list_files(read="report.docx")` |

Also: `set_workspace` / `get_workspace` for the folder. Access is limited to that workspace only.

## How it connects

Claude Desktop starts `python -m gwf_mcp` locally over **stdio** (no host/port).
