ConstructionOnline MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ConstructionOnline MCP Server Draft an estimate from the Riverside lead using our costbook"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Open https://app.constructiononline.com/ in your Cotlet.dev Cloud Browser, sign in with your company user and enable ConstructionOnline for agents.
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:
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Related MCP server: Procore MCP Server
Construction workflows
Examples based on the live ConstructionOnline integration reference:
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_contactsmanage_leadsmanage_opportunitiesmanage_projectsmanage_costbooksmanage_takeoffsmanage_estimatesmanage_bidsmanage_purchase_ordersmanage_change_ordersmanage_selectionsmanage_invoicesmanage_payment_applicationsmanage_schedulemanage_calendarmanage_todosmanage_gameplanmanage_daily_logsmanage_checklistsmanage_timemanage_filesmanage_rfismanage_submittalsmanage_transmittalsmanage_meetingsmanage_chatmanage_warrantiesmanage_complianceview_truevisioncreate_reportview_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:
{"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.
python3 constructiononline_agent.py connect
python3 constructiononline_agent.py guide
python3 constructiononline_agent.py status
python3 constructiononline_agent.py serveYou can also build the included Dockerfile and pass COTLET_API_KEY as an environment variable.
Reference and access
Licensed under Elastic License 2.0. See LICENSE.
Available Tools
7 toolsconstructiononline_clickB
Click a numbered element on the current ConstructionOnline page.
Inputs: element (required).
constructiononline_closeA
Close the ConstructionOnline browser session when the work is done, so credits stop running.
Inputs: no named parameters.
constructiononline_guideA
How to work in ConstructionOnline (construction projects, estimates, RFIs and invoices): its screens and the sign-in link. Call this first.
Inputs: task.
constructiononline_openB
Open a ConstructionOnline page in your signed-in Cloud Browser (default https://app.constructiononline.com) to work with construction projects, estimates, RFIs and invoices.
Inputs: url.
constructiononline_readA
Read the current ConstructionOnline page: its text and numbered buttons, links and fields.
Inputs: element.
constructiononline_statusB
Check that your Cotlet.dev account and ConstructionOnline are ready: account, credits and ConstructionOnline connection.
Inputs: no named parameters.
constructiononline_typeB
Type text into a numbered field on the current ConstructionOnline page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Contractor Foreman MCP server for ChatGPT, Claude and any AI agent: create estimate, add daily log, create change order, update schedule, list invoices and get job costing in your own Contractor Foreman account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Contractor Foreman yourself; Cotlet does not store your password and you need no Contractor Foreman API key. About the official Contractor Foreman API: Contractor Foreman has no public API (checked 11 Oct 2026). Its only programmatic access is a Zapier app with 7 triggers for leads, customers and file uploads, and 2 actions: Create Lead and Create Customer. Setup and FAQ: https://cotlet.dev/integrations/contractor-foreman-api-mcp-server
Buildertrend MCP server for ChatGPT, Claude and any AI agent: get schedule, create daily log, create change order and list selections in your own Buildertrend account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Buildertrend yourself; Cotlet does not store your password and you need no Buildertrend API key. About the official Buildertrend API: Buildertrend publishes no API docs or self-serve keys for customers; it connects through its Marketplace integrations (checked 11 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/buildertrend-api-mcp-server
Procore MCP server for ChatGPT, Claude and any AI agent: list RFIs, create RFI, list submittals, create punch list item, create observation and add manpower entry in your own Procore account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Procore yourself; Cotlet does not store your password and you need no Procore API key. About the official Procore API: Procore has a REST API with OAuth 2.0 and a sandbox, but publishes no MCP server for your own AI agent (checked 5 Nov 2026). The API runs through an app that you register in the Developer Portal and a company admin installs. Setup and FAQ: https://cotlet.dev/integrations/procore-api-mcp-server
Knowify MCP server for ChatGPT, Claude and any AI agent: create job, create bid, create invoice, log time and get job cost report in your own Knowify account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Knowify yourself; Cotlet does not store your password and you need no Knowify API key. About the official Knowify API: Knowify has no public REST API (checked 11 Oct 2026). Its official AI Connector (MCP) lets users with admin permissions ask questions about jobs, billing, labor and collections, and is read-only for now. Setup and FAQ: https://cotlet.dev/integrations/knowify-api-mcp-server
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to JoeAPI construction management system, enabling management of clients, contacts, proposals, estimates, action items, project schedules, and financial data through natural language.1ISC
- FlicenseNot gradedqualityDmaintenanceEnables ChatGPT agents to read Procore project data and create confirmed daily log notes, with project allowlisting and OAuth.-
- AlicenseAqualityBmaintenanceEnables AI agents to operate a signed-in construction management account, creating estimates, updating projects, sending invoices, and querying budget, project, and invoice data through natural language.7Elastic 2.0
- AlicenseAqualityBmaintenanceEnables ChatGPT, Claude, and other AI agents to draft estimates, schedule jobs, assign crew members, and review receivables in a user's signed-in business account, requiring approval before actions reach other people.7Elastic 2.0