Skip to main content
Glama

Ontraccr MCP server for ChatGPT and Claude

ChatGPT, Claude and other AI agents can work with your Ontraccr account through Cotlet.dev. Connect your own signed-in Cloud Browser to review time cards, approve forms, draft field shifts and check project budgets. Approvals, published shifts and actions that reach clients or crews wait for your confirmation.

What you can ask

Review Team Cards waiting for my approval.

List forms pending my approval.

Draft field shifts for next week for my review.

Check hours used against the project budget.

Prepare a change order for signature for my approval.

Move a job card and assign the follow-up.

Related MCP server: ConstructionOnline MCP Server

Connect your account

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

ChatGPT

Add https://cotlet.dev/mcp/v1/connect in Settings > Apps & Connectors, then sign in to Cotlet.dev with OAuth.

Claude

Add https://cotlet.dev/mcp/v1/connect in Settings > Connectors > Add custom connector.

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 Ontraccr 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.

git clone https://github.com/cotlet-connect/ontraccr-mcp.git
cd ontraccr-mcp
python3 ontraccr_agent.py serve

Or with Docker:

docker build -t ontraccr-mcp .
docker run -i --rm -e COTLET_API_KEY ontraccr-mcp

Tools: ontraccr_guide, ontraccr_status, ontraccr_open, ontraccr_read, ontraccr_click, ontraccr_type, ontraccr_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+, standard library only. Run from this repository:

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

Questions from Ontraccr users

Does Ontraccr have a public API or official MCP server?

The Cotlet.dev integration page reports no public Ontraccr API documentation, official Ontraccr MCP server or official ChatGPT or Claude connector found, checked 17 November 2026.

How do I connect Ontraccr to ChatGPT?

Sign up at https://cotlet.dev/signup?app=ontraccr and sign in at app.ontraccr.com/login in your Cotlet.dev Cloud Browser. Add https://cotlet.dev/mcp/v1/connect in ChatGPT with OAuth.

Can I use Ontraccr with Claude?

Yes. Add https://cotlet.dev/mcp/v1/connect as a custom connector in Claude and sign in to Cotlet.dev.

Is this an official Ontraccr MCP server?

No. Cotlet.dev is independent and is not affiliated with, endorsed by or sponsored by Ontraccr.

Integration details

https://cotlet.dev/integrations/ontraccr-api-mcp-server


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

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

Available Tools

7 tools
ontraccr_clickB

Click a numbered element on the current Ontraccr page.

Inputs: element (required).

ontraccr_closeA

Close the Ontraccr browser session when the work is done, so credits stop running.

Inputs: no named parameters.

ontraccr_guideB

How to work in Ontraccr (crew time cards, form approvals, field shifts, project budgets and board cards): its screens and the sign-in link. Call this first.

Inputs: task.

ontraccr_openB

Open a Ontraccr page in your signed-in Cloud Browser (default https://app.ontraccr.com/login) to work with crew time cards, form approvals, field shifts, project budgets and board cards.

Inputs: url.

ontraccr_readA

Read the current Ontraccr page: its text and numbered buttons, links and fields.

Inputs: element.

ontraccr_statusB

Check that your Cotlet.dev account and Ontraccr are ready: account, credits and Ontraccr connection.

Inputs: no named parameters.

ontraccr_typeB

Type text into a numbered field on the current Ontraccr 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.7/5.0

    Scored across 7 tools

    Disambiguation4/5

    The set splits cleanly into meta tools (guide, status), browser lifecycle (open, close), and page interaction (read, click, type), each with a distinct role. The only mild overlap is guide vs. status, both being 'call before doing work' orientation tools, but their descriptions clearly separate onboarding instructions from connectivity/credit checks.

    Naming Consistency5/5

    Every tool uses the same ontraccr_<verb> snake_case pattern with a short, single-purpose verb. There are no mixed conventions or variant spellings, so the pattern is fully predictable.

    Tool Count5/5

    Seven tools is tightly scoped for a browser-automation wrapper: two setup/readiness tools, three interaction primitives, and open/close lifecycle. Nothing appears redundant and no obvious primitive is missing from the count.

    Completeness4/5

    The core agent loop (open a page, read it, click/type, close) is fully covered, plus guidance and status checks. Minor gaps remain for common DOM interactions such as scrolling, selecting dropdown options, or pressing keys, which agents will have to work around via clicking and typing.

    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

    • ClockShark MCP server for ChatGPT, Claude and any AI agent: list time entries, approve timesheet, create job, schedule shift and export payroll hours in your own ClockShark account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to ClockShark yourself; Cotlet does not store your password and you need no ClockShark API key. About the official ClockShark API: ClockShark has no public developer API or API docs (checked 10 Oct 2026). Admins can only generate a Zapier API key, which Zapier uses for 6 triggers and 2 actions: Create Job and Create Task. Setup and FAQ: https://cotlet.dev/integrations/clockshark-api-mcp-server

    • Hubstaff MCP server for ChatGPT, Claude and any AI agent: list timesheets, approve timesheet, review manual time request, add time entry, create project and create task in your own Hubstaff account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Hubstaff yourself; Cotlet does not store your password and you need no Hubstaff API key. About the official Hubstaff API: Hubstaff has a full REST API, API v2, with read and write scopes, and an official MCP server that is read-only (checked 17 Oct 2026). The MCP server reads organizations, members, projects, tasks and time and activity data for owners and managers, cannot create or change anything, and is switched on per organization after an email to Hubstaff support. Setup and FAQ: https://cotlet.dev/integrations/hubstaff-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

    Related MCP Servers

    • 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
    • A
      license
      A
      quality
      B
      maintenance
      Connects a signed-in Bolster contractor account to ChatGPT, Claude, Codex, and Claude Code through Cotlet.dev so users can manage estimates, proposals, schedules, job budgets, bid requests, and customer payment requests, with write actions reviewed before approval.
      7
      Elastic 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables ChatGPT, Claude and other AI agents to manage availability, blocked time, forms, invoices and client reports in a signed-in account, with write actions requiring approval by default. It connects through Cotlet.dev either as a hosted endpoint or as a local stdio server that forwards tool calls.
      7
      Elastic 2.0