Billdr 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., "@Billdr MCP Server List my Billdr projects and read the budget for the kitchen renovation."
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.
Billdr API and MCP server for ChatGPT and Claude
Billdr documents an API key for its Zapier integration on the Titanium plan and no official MCP server (checked 16 November 2026). Cotlet.dev connects ChatGPT, Claude and other AI agents to your own Billdr account through a hosted MCP server with 18 workflow tools. Writes ask for your approval by default.
What you can ask
List my Billdr projects and read the budget for the kitchen renovation.
Draft a quote from my cost catalog and show it to me before saving.
Prepare a change order for a project with a signed quote.
List overdue invoices for this project.
Read crew timesheets and project labor cost.
Draft a client report from the daily logs, keeping it internal until I approve sharing.
Related MCP server: Buildern MCP server
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
ChatGPT
Settings > Apps & Connectors > Create. Use https://cotlet.dev/mcp/v1/connect with OAuth.
Claude
Settings > Connectors > Add custom connector. Use https://cotlet.dev/mcp/v1/connect.
Claude Code
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:
{
"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 Billdr 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.
Clone this repository and run python3 billdr_agent.py serve with COTLET_API_KEY set.
Or with Docker:
docker build -t billdr-mcp .
docker run -i --rm -e COTLET_API_KEY billdr-mcpThe local server exposes seven browser helper tools, distinct from the 18 hosted workflow tools described on the live page.
Local tools: billdr_guide, billdr_status, billdr_open, billdr_read, billdr_click, billdr_type, billdr_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+, nothing else to install. Run from this repo:
export COTLET_API_KEY="your-key"
python3 billdr_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 billdr_agent.py status # is Billdr ready in your Cotlet.dev account
python3 billdr_agent.py guide # Billdr screens and sign-in link
python3 billdr_agent.py read # open Billdr, read the page, close the browser
python3 billdr_agent.py tools # list Cotlet.dev tools
python3 billdr_agent.py serve # start the stdio MCP server (same as no argument)Questions from Billdr users
Does Billdr have a public API or official MCP server?
The live Cotlet.dev page, checked 16 November 2026, reports no public API documentation or official MCP server. Billdr documents a Titanium-plan API key for its Zapier integration.
Which Billdr plan do I need?
Your Billdr plan controls the workflows available. Quotes, invoices, change orders, expenses and the client dashboard are in Starter; scheduling, daily logs, timesheets and budgets require Premium or higher.
Does the agent send changes immediately?
Write tools ask for approval by default. Creating an unsent quote and sending it are separate actions. You can change approval settings per tool.
Is this an official Billdr integration?
No. Cotlet.dev is independent and is not affiliated with Billdr.
Live integration
Billdr tools and connection guide
Start free: https://cotlet.dev/signup?app=billdr&utm_source=github&utm_medium=readme&utm_campaign=billdr
Available Tools
7 toolsbilldr_clickB
Click a numbered element on the current Billdr page.
Inputs: element (required).
billdr_closeA
Close the Billdr browser session when the work is done, so credits stop running.
Inputs: no named parameters.
billdr_guideA
How to work in Billdr (projects, quotes, change orders, invoices, budgets, timesheets and daily logs): its screens and the sign-in link. Call this first.
Inputs: task.
billdr_openA
Open a Billdr page in your signed-in Cloud Browser (default https://app.billdr.co) to work with projects, quotes, change orders, invoices, budgets, timesheets and daily logs.
Inputs: url.
billdr_readB
Read the current Billdr page: its text and numbered buttons, links and fields.
Inputs: element.
billdr_statusA
Check that your Cotlet.dev account and Billdr are ready: account, credits and Billdr connection.
Inputs: no named parameters.
billdr_typeB
Type text into a numbered field on the current Billdr 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 workflow: guidance, readiness check, session opening, reading, clicking, typing, and closing. There is no meaningful overlap between tools, and the descriptions make the intended sequence clear.
All tools use a consistent billdr_ prefix followed by a short, predictable verb or noun. The pattern is uniform across the entire set.
Seven tools is well-scoped for a browser automation server focused on a single application. Each tool corresponds to a necessary lifecycle action without bloat.
The core browser interaction lifecycle is covered: open, read, click, type, and close, plus onboarding and status helpers. Minor gaps exist around scrolling, waiting for page load, or selecting dropdown values, though these may be workable through links and clicks.
Related MCP Connectors
Connect ChatGPT and Claude to Fortnox: invoices, customers, reports. Every write needs your OK.
Read and write Sage Intacct from Claude or ChatGPT. Write tools are flagged for approval.
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
Connect AI to store orders, products and inventory with scoped access and human approvals.
Related MCP Servers
- 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
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to work with a signed-in Buildern contractor account through Cotlet.dev, including estimates, schedules, budgets, bills, client invoices, project to-dos, and site diaries, with review before write operations.Elastic 2.0
- AlicenseAqualityBmaintenanceEnables AI agents to work with estimates, schedules, daily logs, bills, and invoices in a signed-in BuildBook account, with write operations reviewed before approval.7Elastic 2.0
- AlicenseAqualityBmaintenanceConnects ChatGPT, Claude, Codex and Claude Code through Cotlet.dev to a signed-in construction management account, enabling work with projects, estimates, bids, change orders, daily logs, RFIs, invoices and related workflows. It exposes 31 read and write capabilities, most write actions requiring confirmation before anything is sent or changed.7Elastic 2.0