Contractor Foreman by Cotlet — Claude Code MCP server
Connect an AI coding agent to Contractor Foreman to access project records, estimates, daily logs, and invoices. The package also provides a REST API and Python interface.
claude mcp add --transport http contractor-foreman https://cotlet.dev/mcp/v1/contractor-foreman/connectWhat Contractor Foreman by Cotlet does
Contractor Foreman by Cotlet exposes application data through MCP tools. An agent can retrieve project information, inspect schedules, access estimates and invoices, and work with payment records, work orders, and inspections. The project includes 89 tools. Developers can also use a REST API or call operations from Python, with ready-made scripts available in examples/.
The self-hosted server runs in Python and relies on an authenticated Google Chrome session. Running contractor-foreman-mcp connect retrieves browser cookies through the Chrome DevTools Protocol and stores the session in ~/.config/contractor-foreman-api-mcp/session.json. It does not read the account password. Local setup requires Python 3.11 or later, Google Chrome 144 or later, and permission to access the relevant Contractor Foreman modules.
MCP clients can connect over HTTP or stdio, including Claude Code and Codex. The local edition is restricted to noncommercial use. If the web app invalidates the session, the server needs access to Chrome to refresh its authentication. Because requests use the same internal endpoints as the Contractor Foreman web application, changes to those endpoints can affect compatibility.
What it helps with
- Retrieve Contractor Foreman project records through an AI agent
- Inspect schedules and daily work logs
- Access estimates, invoices, and payment records
- Review work orders, inspections, and change orders
- Call Contractor Foreman operations from Python scripts through the REST API
Example prompts for the agent
- Find Contractor Foreman projects whose names contain Oak St.
- Show the estimates and unpaid invoices for the selected Contractor Foreman project.
- Retrieve the latest daily work logs for this project and summarize their entries.
How to install Contractor Foreman by Cotlet
1Platform CLI: remote server
claude mcp add --transport http contractor-foreman https://cotlet.dev/mcp/v1/contractor-foreman/connect2Platform CLI
claude mcp add contractor-foreman-by-cotlet -- uvx contractor-foreman-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from contractor-foreman-api-mcp <command>
1Platform CLI: remote server
codex mcp add contractor-foreman-by-cotlet --url https://cotlet.dev/mcp/v1/contractor-foreman/connect2Platform CLI
codex mcp add contractor-foreman-by-cotlet -- uvx contractor-foreman-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from contractor-foreman-api-mcp <command>
Config file
{
"mcpServers": {
"contractor-foreman-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/contractor-foreman/connect"
}
}
}{
"mcpServers": {
"contractor-foreman-by-cotlet": {
"command": "uvx",
"args": [
"contractor-foreman-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from contractor-foreman-api-mcp <command>
Config file
{
"servers": {
"contractor-foreman-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/contractor-foreman/connect"
}
}
}{
"servers": {
"contractor-foreman-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"contractor-foreman-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from contractor-foreman-api-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http contractor-foreman-by-cotlet https://cotlet.dev/mcp/v1/contractor-foreman/connect2Platform CLI
gemini mcp add contractor-foreman-by-cotlet uvx contractor-foreman-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from contractor-foreman-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Contractor Foreman by Cotlet
How do I install Contractor Foreman by Cotlet in Claude Code?
For the hosted MCP endpoint, run claude mcp add --transport http contractor-foreman https://cotlet.dev/mcp/v1/contractor-foreman/connect. To launch the local package, run claude mcp add contractor-foreman-by-cotlet -- uvx contractor-foreman-api-mcp.
What does Contractor Foreman by Cotlet do?
It gives AI agents MCP access to Contractor Foreman records, including projects, schedules, estimates, invoices, and payments. It also exposes a REST API and Python interface.
What are the requirements for running the local MCP server?
You need Python 3.11 or later, Google Chrome 144 or later signed in to Contractor Foreman, and access rights for the modules you intend to use. Run contractor-foreman-mcp connect to retrieve the browser session.
