ConstructionOnline MCP Server
# ConstructionOnline MCP server through Cotlet.dev
Connect ConstructionOnline to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Work with projects, estimates, bids, daily logs, RFIs and invoices in your own signed-in company account.
This is an unofficial integration, not affiliated with ConstructionOnline. Cotlet.dev hosts the connection through your Cloud Browser. This repository provides an optional Python stdio MCP bridge.
## Connect your account
1. [Request access to ConstructionOnline](https://cotlet.dev/signup?app=constructiononline).
2. Open https://app.constructiononline.com/ in your Cotlet.dev Cloud Browser, sign in with your company user and enable ConstructionOnline for agents.
3. Connect your agent. Refresh the connector if you enabled ConstructionOnline after connecting.
### ChatGPT
Open Settings > Apps & Connectors > Create. Enter `https://cotlet.dev/mcp/v1/connect` as the MCP server URL and choose OAuth.
### Claude
Open Settings > Connectors > Add custom connector and enter `https://cotlet.dev/mcp/v1/connect`.
### Codex
Create a Cotlet.dev API key in your console and set `COTLET_API_KEY` in your environment. Add:
```toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```
### Claude Code
```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```
## Construction workflows
Examples based on the [live ConstructionOnline integration reference](https://cotlet.dev/integrations/constructiononline-api-mcp-server):
- Turn a lead into an estimate using your costbook.
- Compare bids and draft a purchase order for review.
- Prepare an invoice from an approved change order.
- Log the day and update a project schedule.
- Review open RFIs, submittals and punch items.
- List expiring insurance and permits.
The live reference lists 31 capabilities: 3 read and 28 write. The hosted groups are `constructiononline_read` and `constructiononline_write`. Operations:
- `manage_contacts`
- `manage_leads`
- `manage_opportunities`
- `manage_projects`
- `manage_costbooks`
- `manage_takeoffs`
- `manage_estimates`
- `manage_bids`
- `manage_purchase_orders`
- `manage_change_orders`
- `manage_selections`
- `manage_invoices`
- `manage_payment_applications`
- `manage_schedule`
- `manage_calendar`
- `manage_todos`
- `manage_gameplan`
- `manage_daily_logs`
- `manage_checklists`
- `manage_time`
- `manage_files`
- `manage_rfis`
- `manage_submittals`
- `manage_transmittals`
- `manage_meetings`
- `manage_chat`
- `manage_warranties`
- `manage_compliance`
- `view_truevision`
- `create_report`
- `view_redline_planroom`
`view_truevision`, `create_report` and `view_redline_planroom` read without changing ConstructionOnline. Write tools take an `action`; supported `list` and `get` actions only read. Other actions ask for confirmation by default, which you can change per tool. Review recipients, amounts and content before sending bids, RFIs, invoices or messages. Delivered messages and invoices already reach their recipients.
Your ConstructionOnline plan and company user's permissions determine the available projects and features. ClientLink and TeamLink portal accounts are outside the documented company-user workflow. The agent reads and moves Redline takeoff data; it does not measure drawings. Account settings and company permissions are outside these tools.
## Optional local stdio bridge
Python 3.10 or newer is required, with no runtime dependencies. Clone this repository and configure a client that supports stdio:
```json
{"mcpServers":{"constructiononline":{"command":"python3","args":["/absolute/path/to/constructiononline-mcp/constructiononline_agent.py"],"env":{"COTLET_API_KEY":"your-cotlet-key"}}}}
```
The local bridge lists seven browser helpers: `constructiononline_guide`, `constructiononline_status`, `constructiononline_open`, `constructiononline_read`, `constructiononline_click`, `constructiononline_type` and `constructiononline_close`. They forward to Cotlet.dev's shared browser tools and are distinct from the 31 hosted workflow capabilities. Call the guide first and close the browser when finished. Discovery works without a key; executing a tool requires your Cotlet.dev key and connected account.
```bash
python3 constructiononline_agent.py connect
python3 constructiononline_agent.py guide
python3 constructiononline_agent.py status
python3 constructiononline_agent.py serve
```
You can also build the included Dockerfile and pass `COTLET_API_KEY` as an environment variable.
## Reference and access
- [ConstructionOnline connection guide and operation reference](https://cotlet.dev/integrations/constructiononline-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=constructiononline)
- [Request access](https://cotlet.dev/signup?app=constructiononline)
- [Cotlet.dev console](https://cotlet.dev/app)
Licensed under Elastic License 2.0. See LICENSE.
TDQS
Scored across 7 tools
Each tool maps to a distinct step in the browser loop: guide (instructions), status (account readiness), open (start session), read (inspect page), click/type (interact), close (end session). The guide-vs-open and read-vs-status pairs are separated clearly by their descriptions and sequencing hints. No two tools appear to do the same thing.
All seven tools share the same 'constructiononline_' prefix in snake_case, which makes the set instantly recognizable. The only minor deviation is that guide and status are nouns while the rest use verbs, but the prefix convention keeps it predictable.
Seven tools is well-scoped for a browser-automation server: setup (guide, status), session lifecycle (open, close), and page interaction (read, click, type). Every tool earns its place with no filler.
The core act-observe loop is covered end to end, including credit-saving close and a guide/status onboarding path. Minor gaps remain for common automation needs such as scrolling, waiting for load, navigation/back, or submitting a form (pressing Enter) without a click.