Skip to main content
Glama
Billdr MCP Server

Billdr MCP Server

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-mcp

The 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


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

Start free: https://cotlet.dev/signup?app=billdr&utm_source=github&utm_medium=readme&utm_campaign=billdr

Available Tools

7 tools
billdr_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

    A3.8/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools use a consistent billdr_ prefix followed by a short, predictable verb or noun. The pattern is uniform across the entire set.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      7
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      B
      maintenance
      Connects 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.
      7
      Elastic 2.0