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:)

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

Claude Desktop

Settings → Developer → Edit Config, then add:

{
  "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 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