Skip to main content
Glama
README.md
# Buildern MCP server

Connect Buildern to ChatGPT, Claude and other AI agents through Cotlet.dev. Work with estimates, schedules, bills and client invoices in your signed-in contractor account. Review write operations before approving them.

## What you can ask

> Read the budget for the Oak Lane kitchen remodel and summarize recorded costs.

> Draft an estimate from the takeoff quantities I provide, then show me the lines before saving.

> List this week's project to-dos and read the latest site diary.

## Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.

### ChatGPT

Settings → Apps → add connector URL `https://cotlet.dev/mcp/v1/connect`, then sign in with Cotlet.dev. No API key needed.

### Claude Code

```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```

### Cursor

Copy `.cursor/mcp.json` from this repo into your project:

```json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}
```

## Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Buildern tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Run the included Python module with Python 3.10 or later:

```bash
python3 buildern_agent.py serve
```

Or with Docker:

```bash
docker build -t buildern-mcp .
docker run -i --rm -e COTLET_API_KEY buildern-mcp
```

Tools: `buildern_guide`, `buildern_status`, `buildern_open`, `buildern_read`, `buildern_click`, `buildern_type`, `buildern_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

## Command line

Python 3.10+, with no third-party runtime dependencies. Clone this repository and run:

```bash
export COTLET_API_KEY="your-key"
python3 buildern_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 buildern_agent.py status    # is Buildern ready in your Cotlet.dev account
python3 buildern_agent.py guide     # Buildern screens and sign-in link
python3 buildern_agent.py read      # open Buildern, read the page, close the browser
python3 buildern_agent.py tools     # list Cotlet.dev tools
python3 buildern_agent.py serve     # start the stdio MCP server (same as no argument)
```

## Questions from Buildern users

**How do I connect my account?**

Request access at https://cotlet.dev/signup?app=buildern, sign in to Buildern in your Cotlet.dev Cloud Browser and enable it for agents.

**Can I review changes?**

The hosted integration asks for confirmation before write calls by default. Preparing a client invoice and sending it are separate calls.

**Does Buildern provide an API?**

Buildern publishes API documentation and directs API access through its contact flow. The Cotlet.dev page reports no verified official Buildern MCP server as checked on 13 November 2026.

**Is Cotlet.dev affiliated with Buildern?**

No. Cotlet.dev is independent and not affiliated with Buildern.

## Learn more

- [buildern integration and hosted tools](https://cotlet.dev/integrations/buildern-api-mcp-server)

---

More: https://cotlet.dev/integrations/buildern-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=buildern

Request access: https://cotlet.dev/signup?app=buildern&utm_source=github&utm_medium=readme&utm_campaign=buildern

## Workflows on the hosted integration

Examples documented on the live integration page:

- `manage_projects`
- `view_dashboards`
- `manage_budget_tab`
- `perform_takeoff`
- `create_estimates`
- `manage_cost_codes`
- `create_proposals`
- `manage_templates`
- `manage_schedule`
- `manage_to_dos`
- `record_daily_logs_site_diary`
- `track_timesheets`
- `manage_files`
- `manage_bid_requests_request_for_quote`
- `manage_purchase_orders`
- `manage_bills`
- `manage_selections_and_allowances`
- `manage_change_orders_variations`
- `manage_client_invoices`
- `manage_clients`
- `manage_subcontractors_vendors`

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.