MCP App Store
by KeenEthics
ContractorOS icon

ContractorOS MCP Server for ChatGPT

By Frontline Strategic Advisory

Overview

ContractorOS helps independent contractors and small crews keep job information connected to their work. Find jobs and review their status, save field updates and provisional measurements, and save or retrieve job photos and documents in your authorized workspace. Maintain material lists, record helper time, and prepare quote versions and private invoice PDF drafts. Record customer approvals or reported payments only when explicitly instructed and supported by actual details. Drafts are not automatically sent, supplier orders are not placed, and ContractorOS does not transfer money. An activated ContractorOS account and authorized workspace membership are required. Account activation is currently invitation-based. Available actions depend on your permissions and enabled features. HEIC/HEIF photos must be exported to JPEG or PNG before upload.

How to connect

  1. ChatGPT: Open the ContractorOS listing in the ChatGPT app directory and choose Connect. ChatGPT listing ContractorOS exposes 27 tools here.

Tools

add_job_update

ChatGPT
Save an ordinary job update with optimistic concurrency. Never sends, orders, or pays.

add_measurement

ChatGPT
Save a provisional or confirmed field measurement.

correct_helper_time

ChatGPT
Correct or void one dated shift with a reason and revision. Voiding an accidental duplicate removes it from totals; genuine separate shifts stay separate.

create_job

ChatGPT
Create a job with optional original scope.

create_material_list

ChatGPT
Save a concise material list. This never places an order.

draft_invoice

ChatGPT
Generate a private shareable PDF invoice draft. This never sends or marks it paid.

draft_invoice_from_quote

ChatGPT
Draft a private invoice PDF using the exact approved quote lines, price, exclusions and deposit/payment terms. No sending or money movement.

find_jobs

ChatGPT
Find jobs by customer, title, address, or alias. Automatically use one clear match. If several match, show each title, customer, and address and ask the user to select one before saving. For native ChatGPT attachments, use save_chatgpt_files_to_job with the resolved job ID; do not open a picker.

get_job_status

ChatGPT
Retrieve the latest durable job state.

get_material_counter_list

ChatGPT
Read a concise supplier-counter list from persisted quantities. Still needed uses max(picked up, delivered), avoiding double-counting the same boards in both stages, and adds recorded returns.

get_my_account

ChatGPT
Read your authenticated identity, tenant, and membership role. No identity or tenant arguments are accepted.

get_pilot_daily_report

ChatGPT
Read one saved aggregate ContractorOS pilot report through an explicit aggregate-only access grant. This never grants access to the subject tenant's jobs, customers, photos, conversations, Gmail, or calendar.

get_workspace_usage_report

ChatGPT
Read current stored totals and observed activity for a specifically authorized pilot workspace. Requires a separate detail grant naming the subject identity; an aggregate report grant is insufficient. Reviewer reads are excluded from subject telemetry.

list_jobs

ChatGPT
List up to 100 jobs in your authenticated tenant, with title, customer, and address. Reports truncation; never infer a job outside this list.

prepare_invoice_download

ChatGPT
Create a five-minute download access grant for the exact saved invoice PDF. Does not regenerate, send, charge, or change the invoice.

prepare_job_photo_upload

ChatGPT
Fallback only: prefer save_chatgpt_files_to_job for native ChatGPT attachments. Use this card when direct attachment transfer is unavailable and the user chooses the fallback, or explicitly asks to select new files in a card. Explain the direct-transfer failure first; never silently request a second selection. After resolving the exact job, prepare a five-minute private upload card for its authenticated job ID. If several jobs matched, require the user's explicit selection first. Set maxFiles to 10 for a photo batch. A new card revokes earlier cards for this member. The card confirms job and customer; it never records expenses or payments.

propose_scope_change

ChatGPT
Record a proposed change without approving it.

record_customer_approval

ChatGPT
Only on explicit instruction, record actual customer approval of a scope or quote with the customer approval reference. A draft is not approval.

record_customer_payment

ChatGPT
Record a customer payment only after explicit authorization. A check photo alone is never payment.

record_helper_time

ChatGPT
Record helper hours and amount owed, separate from customer receivables.

record_material_progress

ChatGPT
Record explicitly reported quantities ordered, picked up, delivered or returned. Link a receipt as evidence; no receipt total is added as a second expense.

resolve_job

ChatGPT
Find candidate jobs for a description. If needs_clarification, show every candidate title, customer, and address and ask the user to select one explicitly. Automatically use one matching job, including a unique customer or alias match. For native ChatGPT attachments, use the chosen job ID for save_chatgpt_files_to_job without another picker. Use prepare_job_photo_upload only as an explicitly chosen fallback when direct transfer is unavailable.

revise_material_list

ChatGPT
Revise needed quantities or known unit costs in an existing list with revision guard and before/after history. Does not place orders.

save_chatgpt_files_to_job

ChatGPT
Save all requested original attachments already supplied in ChatGPT only when its format, connected user, tenant and exact job are enabled. Up to 10 files, maximum 15 MiB combined; return and report a result for every requested file. Originals are not converted. JPEG, static PNG, passive PDF and macro-free DOCX validation is available in this controlled candidate; format approval is required. HEIC is unsupported. Some complex documents and animated PNGs are rejected. Use real authorized file objects, independently verify saved bytes, and report exact failures without substituting browser uploads.

save_quote_version

ChatGPT
Save a proposed quote. First version requires every document field. Later versions patch only explicitly changed fields and preserve omitted terms; approval does not carry to revised versions.

test_chatgpt_attachment_access

ChatGPT
Run a one-photo diagnostic inside ChatGPT. The widget requests a fresh temporary URL and attempts an in-memory browser read. It does not save, upload to ContractorOS, inspect the photo, create evidence, or retain the file ID or URL. Use only when the user explicitly requests this diagnostic.

verify_job_evidence

ChatGPT
Independently reopen saved evidence bytes for the exact job and verify size and SHA-256. Use after saving or in a fresh conversation to confirm the files remain retrievable. No picker, upload or browser page.

Capabilities

WritesInteractive

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/contractoros"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/contractoros)