[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# How to connect Contractor Foreman to ChatGPT, Claude and AI agents

> Contractor Foreman's own guide says to copy ChatGPT text into the daily log. How builders let ChatGPT or Claude work in their projects directly instead.

Source: https://cotlet.dev/blog/how-to-connect-contractor-foreman-to-chatgpt-claude

Contractor Foreman's own guide says to copy ChatGPT text into the daily log. How builders let ChatGPT or Claude work in their projects directly instead.

Cotlet team · Nov 9, 2026 · 11 min read

On this page

1. [01 What ChatGPT and Claude can do in Contractor Foreman once connected](#what-chatgpt-and-claude-can-do-in-contractor-foreman-once-connected)
2. [02 Does Contractor Foreman have AI, an API or an official ChatGPT app?](#does-contractor-foreman-have-ai-an-api-or-an-official-chatgpt-app)
3. [03 What to have ready](#what-to-have-ready)
4. [04 Step 1: sign in to Contractor Foreman in your Cloud Browser](#step-1-sign-in-to-contractor-foreman-in-your-cloud-browser)
5. [05 Step 2: connect Contractor Foreman to ChatGPT, Claude or another AI agent](#step-2-connect-contractor-foreman-to-chatgpt-claude-or-another-ai-agent)
6. [06 Three Contractor Foreman jobs to try first](#three-contractor-foreman-jobs-to-try-first)  
  1. [Catch a project going over budget](#catch-a-project-going-over-budget)
  2. [Turn a change order request into a change order](#turn-a-change-order-request-into-a-change-order)
  3. [Write the daily log without copy and paste](#write-the-daily-log-without-copy-and-paste)
7. [07 The cost of Cotlet](#the-cost-of-cotlet)
8. [08 FAQ](#faq)  
  1. [Does Contractor Foreman have an API?](#does-contractor-foreman-have-an-api)
  2. [Is there a Contractor Foreman MCP server?](#is-there-a-contractor-foreman-mcp-server)
  3. [Does Contractor Foreman work with ChatGPT or Claude?](#does-contractor-foreman-work-with-chatgpt-or-claude)
  4. [Can ChatGPT read my projects and estimates in Contractor Foreman?](#can-chatgpt-read-my-projects-and-estimates-in-contractor-foreman)
  5. [Is this an official Contractor Foreman integration?](#is-this-an-official-contractor-foreman-integration)
9. [09 Stop pasting from ChatGPT](#stop-pasting-from-chatgpt)

Contractor Foreman, the construction management software, has no public API and no ChatGPT or Claude app, as of November 2026\. Its own blog suggests you “copy the formatted log from ChatGPT and paste it into the daily log field”, and its Zapier MCP can only create a customer or a lead. To have ChatGPT, Claude or another AI agent work in your projects, estimates and logs directly, connect it with Cotlet. Log in to Contractor Foreman once in a cloud browser that Cotlet runs, and your AI works there as you do. Allow ten minutes; no coding.

Cotlet is for the owner, project manager or office admin who runs a construction company in Contractor Foreman and wants AI to handle the admin across jobs. Your clients still sign estimates and change orders the way Contractor Foreman sends them. This guide is about the back office: the budget nobody checked this week, estimates waiting on a signature, the daily logs from Friday.

## What ChatGPT and Claude can do in Contractor Foreman once connected

The AI opens Contractor Foreman in your logged-in Cloud Browser and moves through the same menus as your office:

| Contractor Foreman area | What you can ask your AI to do |
| ----------------------- | ------------------------------------------------------------------------ |
| Projects | List active projects, read the project financials and reports |
| Estimates | List estimates by status, add items, send a reminder for an unsigned one |
| Change orders | Create a change order and import items from a change order request |
| Daily Logs | Create today’s log from your notes, add the crew, set it to Complete |
| Time cards | Read hours by project and employee for a week |
| Leads and customers | Find a customer, add a lead with notes |

Anything sent to a client, sub or employee waits for you to approve it. The AI reads projects, reports and logs without asking.

The technical side is on Cotlet’s [Contractor Foreman integration page](https://cotlet.dev/integrations/contractor-foreman-api-mcp-server.md).

## Does Contractor Foreman have AI, an API or an official ChatGPT app?

Contractor Foreman has AI for writing estimates and a Zapier app with a short list of actions. Nothing lets your AI into the account.

- **Copy and paste from ChatGPT.** Contractor Foreman’s [ChatGPT guide](https://contractorforeman.com/using-chatgpt-in-construction-where-it-actually-helps/) (checked 9 November 2026) tells you to “Simply copy the formatted log from ChatGPT and paste it into the daily log field”. ChatGPT writes, you paste.
- **Zapier, 2 actions.** The [Zapier MCP for Contractor Foreman](https://zapier.com/mcp/contractor-foreman) supports “Create Customer” and “Create Lead”. It cannot read a project, an estimate or a log.
- **No API.** Contractor Foreman offers no developer docs and no API keys outside the Zapier setup, and n8n has no node for it.
- **AI Estimator and Write with AI** help you draft estimates inside Contractor Foreman. They do not take instructions from ChatGPT or Claude.

For an AI that actually works in your projects today, the route is a hosted MCP server that uses Contractor Foreman as you. If an API arrives, use it.

## What to have ready

- A Contractor Foreman login with access to the projects, financials and logs you want the AI on. The owner or an admin covers every project.
- An AI: ChatGPT on chatgpt.com, or Claude on the web or the desktop app (its free plan allows one custom connector).
- A Cotlet account; try it [7 days free](https://cotlet.dev/pricing.md) with 2,000 credits, no card.

## Step 1: sign in to Contractor Foreman in your Cloud Browser

Open the Web browser in the Cotlet console, go to Contractor Foreman’s login page and log in with your usual credentials. Cotlet keeps that browser running on its side with you logged in, so the AI can check budgets on Friday night.

Cotlet is not part of that login step: the password stays between you and Contractor Foreman, and Cotlet saves only the session cookie, encrypted. A forced re-login means a short pause, with a link sent to you to finish it. How we protect sessions is on the [security page](https://cotlet.dev/security.md).

## Step 2: connect Contractor Foreman to ChatGPT, Claude or another AI agent

Start with whichever chat app your project managers already have open all day. More can be added later on the same login.

**ChatGPT**chatgpt.com and its apps **Claude**claude.ai and desktop app **Claude Code**one terminal command **Codex**one entry in config.toml **Cursor**one entry in mcp.json **Grok**grok.com connectors **Hermes Agent**one block in config.yaml **n8n**MCP Client node **Any MCP client**OpenClaw and others

Pick your AI above to see its steps.

### How to connect Contractor Foreman to ChatGPT

Do this on chatgpt.com in your browser. Cotlet then works in the ChatGPT desktop and phone apps too.

1. Open [Plugins in ChatGPT](https://chatgpt.com/plugins) and click Add.
2. Click Add custom MCP server. Not in the menu? Turn on Developer mode in Settings, Security and login, then come back.
3. Paste the name `Cotlet` and the server URL `https://cotlet.dev/mcp/v1/connect`. Keep Authentication on OAuth.
4. Tick “I understand and want to continue” and click Create as a plugin.
5. Click Connect Cotlet. A Cotlet page opens, click Allow access.
6. In a new chat, type `@Cotlet` and pick it from the list.
7. Ask ChatGPT: “Are you signed in to Cotlet through MCP?” Then try a first Contractor Foreman task: “List my active Contractor Foreman projects with their estimate status.”

_ChatGPT, Add menu on the Plugins page, November 2026._

_ChatGPT, picking Cotlet in a new chat with @, November 2026._

ChatGPT asks “Allow ChatGPT to use Cotlet?” before some steps. Pick Always allow, or the chat waits for your click. On a Business, Enterprise or Edu workspace, an admin has to allow custom MCP servers first.

### How to connect Contractor Foreman to Claude

1. Open [Connectors in Claude](https://claude.ai/customize/connectors) and click Add. In the desktop app it is under Customize, Connectors.
2. Click Add custom connector.
3. Paste the name `Cotlet` and the URL `https://cotlet.dev/mcp/v1/connect`, then click Continue.
4. Keep the settings and click Add.
5. A Cotlet page opens. Click Allow access.
6. In a chat, click the plus button, then Connectors, and turn Cotlet on.
7. Ask Claude: “Are you signed in to Cotlet through MCP?”, then “Which Contractor Foreman projects have no daily log in the last three days?”. Claude asks before it uses a Cotlet tool the first time. Click Allow.

_Claude, Add custom connector, last screen, November 2026._

_Claude, chat menu, Connectors, November 2026._

Claude’s free plan allows one custom connector. On a Team or Enterprise plan, an owner adds Cotlet in Organization settings, Connectors, and you click Connect next to it.

### How to connect Contractor Foreman to Claude Code

Add Cotlet without a key, then sign in once in the browser:

```
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1/connect
```

Run `/mcp` in Claude Code, pick cotlet and sign in to Cotlet. Prefer an API key, for example on a server? Create one in the Cotlet console and use:

```
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

### How to connect Contractor Foreman to Codex

Create an API key in the Cotlet console, put it in the `COTLET_API_KEY` environment variable and add this to `~/.codex/config.toml`:

```
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

### How to connect Contractor Foreman to Cursor

Create an API key in the Cotlet console, put it in the `COTLET_API_KEY` environment variable and add this to `~/.cursor/mcp.json`:

```
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}
```

### How to connect Contractor Foreman to Grok

Grok takes custom MCP servers on grok.com, per xAI’s [connectors documentation](https://docs.x.ai/grok/connectors) (checked 8 November 2026).

1. Open [grok.com/connectors](https://grok.com/connectors) and click New Connector.
2. Pick Custom and paste the server URL `https://cotlet.dev/mcp/v1/connect`.
3. Sign in to Cotlet when Grok asks, then click Allow access.
4. Ask Grok: “Are you signed in to Cotlet through MCP?”

On Grok Business, an admin adds the connector first in the xAI console, under Grok Business, Connectors. The Grok chat inside X has no custom connector menu.

### How to connect Contractor Foreman to Hermes Agent

Add Cotlet to `~/.hermes/config.yaml` in the format of the [Hermes MCP config reference](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference):

```
mcp_servers:
cotlet:
url: "https://cotlet.dev/mcp/v1"
headers:
Authorization: "Bearer ${COTLET_API_KEY}"
trust: untrusted
```

Put `COTLET_API_KEY` in `~/.hermes/.env` and check it with `hermes mcp test cotlet`. With `trust: untrusted`, Hermes runs reads at once and asks before every write. More on Hermes in our post on the [Hermes Agent browser](https://cotlet.dev/blog/hermes-agent-browser.md).

### How to connect Contractor Foreman to n8n

Use the MCP Client node, or the MCP Client Tool inside an AI Agent node:

- Server Transport: HTTP Streamable
- MCP Endpoint URL: `https://cotlet.dev/mcp/v1`
- Authentication: Bearer Auth, with your Cotlet API key as the token
- Tools: let the AI Agent node use Cotlet’s browser tools; it reads Cotlet’s Contractor Foreman guide first and works in your logged-in Contractor Foreman

Use it for work that should run on its own, such as a Friday budget check on every active project, emailed to you before the weekend.

### Any other MCP client

Point the client at `https://cotlet.dev/mcp/v1` over Streamable HTTP, with the header `Authorization: Bearer <your Cotlet API key>`. A client that supports OAuth sign-in can use `https://cotlet.dev/mcp/v1/connect` instead and needs no key. The full reference is in the [MCP docs](https://cotlet.dev/docs/mcp.md).

## Three Contractor Foreman jobs to try first

Do one for a live project and check it in Contractor Foreman when the AI is done.

### Catch a project going over budget

> Every Friday, check the financials on my active projects and tell me which ones are over budget or within 10 percent of it, with the cost codes that moved.

The AI opens each project’s financials and reports and gives you one short list. That fills a real gap: Contractor Foreman’s knowledge base says “Currently, there is no ‘Notification’ for this feature” and suggests checking the Project Financial and Report sections yourself, per its [over-budget article](https://kb.contractorforeman.com/knowledge-base/how-do-i-receive-a-notification-that-my-project-has-gone-over-budget/). Now someone checks every week.

### Turn a change order request into a change order

> The Pine Street client approved the COR for the extra deck stairs. Create the change order from it and send it for signature once I check it.

The AI creates a new change order and imports the items from the request, because a change order request “cannot be converted directly into a Change Order”, per Contractor Foreman’s [COR article](https://kb.contractorforeman.com/knowledge-base/how-do-i-convert-a-change-order-request-to-a-change-order/). It shows you the total before anything goes to the client.

### Write the daily log without copy and paste

> Here are my notes from the Oak Avenue site today: framing done on the second floor, inspector Tuesday, two guys out. Create today’s daily log, add the crew and mark it complete.

The AI writes the log in Contractor Foreman from your notes, adds the crew and sets the status to Complete, which in Contractor Foreman means “No more notes need to be added to the Daily Log”, per its [log status article](https://kb.contractorforeman.com/knowledge-base/how-do-i-update-the-daily-log-status/). If you might add photos later, ask it to leave the log In Progress.

## The cost of Cotlet

There is no subscription. Cotlet sells credit packs from $29, good for 12 months, and gives every new account 7 days and 2,000 credits free, card not required. You are not charged for failed calls. See the [pricing page](https://cotlet.dev/pricing.md).

Your Contractor Foreman plan does not change, and Cotlet needs no Zapier account.

## FAQ

### Does Contractor Foreman have an API?

There is a key, but it only unlocks Zapier. No developer documentation exists for anything else, as of November 2026.

### Is there a Contractor Foreman MCP server?

Zapier’s has two actions, both for adding people: a customer or a lead. The one Cotlet hosts covers projects, estimates, change orders and logs, and runs against your live account.

### Does Contractor Foreman work with ChatGPT or Claude?

Only as a writing aid you copy from, per Contractor Foreman’s own guide. Connected through Cotlet, the assistant saves its work in Contractor Foreman itself.

### Can ChatGPT read my projects and estimates in Contractor Foreman?

Yes, once connected through Cotlet: project lists, estimate statuses and financials are all readable, and edits happen only with your approval.

### Is this an official Contractor Foreman integration?

No. Cotlet is independent and not affiliated with Contractor Foreman. It works through your own signed-in Contractor Foreman account, the way you would by hand.

## Stop pasting from ChatGPT

Your AI can do more than draft text for the daily log. [Start with Cotlet](https://cotlet.dev/signup?app=contractor-foreman), log in to Contractor Foreman in the Cloud Browser, and ask Claude which projects are close to budget. For other construction apps with no API, look through the [integrations catalog](https://cotlet.dev/integrations.md).

## Keep reading

[All posts](https://cotlet.dev/blog.md)

- [Agents Nov 9, 2026 How to connect BookingKoala to ChatGPT, Claude and any AI agent Zapier's BookingKoala MCP can only create a lead. How cleaning companies let ChatGPT or Claude read bookings, assign providers and handle refunds. Cotlet team · 10 min read](https://cotlet.dev/blog/how-to-connect-bookingkoala-to-chatgpt-claude.md)
- [Agents Nov 9, 2026 How to connect Booksy to ChatGPT, Claude and any AI agent Booksy's ChatGPT plugin only shows clients your open slots. How to let ChatGPT or Claude work in your own Booksy Biz calendar, clients and reports. Cotlet team · 12 min read](https://cotlet.dev/blog/how-to-connect-booksy-to-chatgpt-claude.md)
- [Agents Nov 9, 2026 How to connect Buildertrend to ChatGPT, Claude and any AI agent Buildertrend's Open API covers jobs and tasks, in early access. How builders let ChatGPT or Claude write daily logs, move schedules and draft change orders. Cotlet team · 11 min read](https://cotlet.dev/blog/how-to-connect-buildertrend-to-chatgpt-claude.md)

## Have an app in mind?

Sign up and add it in the console. Not in the list? Ask for it there.

[Sign up free](https://cotlet.dev/signup)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.