# BOQ MCP Server

Let Claude fill data into your **BOQ / Tendix** projects in plain language — create
projects, chapters, sections, items, quantity calculations, contractors, contracts,
bills, and pricing. It talks to the BOQ REST API, so all your permissions, subscription,
and audit rules stay enforced. You only see and touch the data your account is allowed to.

## Install in one step

### Claude Code

Just tell Claude:

> Install the MCP server from https://github.com/jehadbaniodeh/boq-mcp

Claude will run the registration for you. (Or run it yourself:)

```bash
claude mcp add boq -- uvx --from git+https://github.com/jehadbaniodeh/boq-mcp boq-mcp
```

### Claude Desktop

Settings → Developer → Edit Config, then add:

```json
{
  "mcpServers": {
    "boq": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/jehadbaniodeh/boq-mcp", "boq-mcp"]
    }
  }
}
```

Restart Claude Desktop. Done.

## First use

In any chat, log in once with your BOQ account:

> Log in to BOQ as me@example.com

Then talk to it naturally:

> Create a project "Villa A" with a Concrete chapter (code 03), a Foundations
> section (code 10), and an item "Reinforced concrete C30" in m3 at 250/unit.

If your account lacks a permission, Claude is told exactly why (e.g. a 403), so it can
explain it instead of silently failing.

## Requirements

- **[uv](https://docs.astral.sh/uv/) installed** (provides `uvx`). One-time:
  `curl -LsSf https://astral.sh/uv/install.sh | sh`
  `uvx` then downloads and runs the server automatically — no manual clone or `pip install`.
- A BOQ account on https://boq.jehadbim.com.

By default the server targets `https://boq.jehadbim.com`. To point at a different
instance, set `BOQ_API_URL` in the server's `env` block.

## Tools

| Area | Tools |
|------|-------|
| Auth / read | `login`, `whoami`, `list_projects`, `get_project_tree`, `list_chapters`, `list_sections`, `list_items` |
| BOQ hierarchy | `create_project`, `update_project`, `create_chapter`, `create_section`, `create_item`, `bulk_create_items`, `add_calculation_line` |
| Commercial | `create_contractor`, `create_contract`, `create_bill` |
| Pricing | `add_material_cost`, `get_pricing_breakdown` |

## Notes

- Chapter / section / item **codes are exactly 2 digits** (e.g. `03`) — the full path
  code is composed up the tree.
- Item **units**: `m, m2, m3, unit, kg, ton, lm, ls, No., set`.
- Your login token lives only in memory for the running session; it is never written to disk.

## License

MIT