The MCP server dev.cotlet/tradify provides access to Tradify data related to jobs, quotes, invoices, and scheduling. Its purpose is centered on managing operational records and time-related information within the Tradify domain, as indicated by its description: “Jobs, quotes, invoices and schedule in Tradify.”
🛠️ Key Features
Jobs
Quotes
Invoices
Schedule
🚀 Use Cases
Retrieve or work with Tradify jobs
Access Tradify quotes
Manage Tradify invoices
View or handle Tradify scheduling information
⚡ Developer Benefits
Clear domain scope around Tradify records (jobs, quotes, invoices, schedule)
Predictable feature set based on the server description
⚠️ Limitations
No tool list, topics, or readme excerpt were provided in the available data, so supported tool names and interfaces cannot be confirmed.
The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call and its credit balance. Free. Needs the user's Cotlet API key or sign-in.
The apps of the user's workspace and whether each works now: access granted or requested, the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.
Parameters1
app
string
optional
Only this app, e.g. skool.
Raw schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only this app, e.g. skool."
}
},
"additionalProperties": false
}
cotlet_request_apps
Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. An app with dedicated tools gets them after the user signs in to it in their Cloud Browser; any other works now in the user's Web browser with cotlet_app_guide, and the Cotlet team builds its dedicated tools on demand. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.
Parameters2
apps
array
required
App slugs, e.g. ["skool", "substack"].
use_case
string
optional
What the user wants the agent to do in these apps, in their words.
Raw schema
{
"type": "object",
"properties": {
"apps": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"description": "App slugs, e.g. [\"skool\", \"substack\"]."
},
"use_case": {
"type": "string",
"maxLength": 1000,
"description": "What the user wants the agent to do in these apps, in their words."
}
},
"required": [
"apps"
],
"additionalProperties": false
}
cotlet_get_call
Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.
Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL works once. Free. Needs the user's Cotlet API key or sign-in.
Sends a report straight to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a tool, field or app the task needed and Cotlet lacks. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.
Parameters7
kind
string
required
bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.
title
string
required
One line, e.g. 'skool_list_members stops after 50 members'.
description
string
required
What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.
app
any
optional
App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'.
tool
any
optional
Tool or endpoint name, e.g. 'skool_list_members'.
call_id
any
optional
call_id of the call that went wrong, if any.
client
any
optional
Agent or tool sending this, e.g. 'Claude Code'.
Raw schema
{
"type": "object",
"properties": {
"kind": {
"description": "bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.",
"enum": [
"bug",
"error",
"feature_request",
"missing_feature",
"other"
],
"title": "Kind",
"type": "string"
},
"title": {
"description": "One line, e.g. 'skool_list_members stops after 50 members'.",
"maxLength": 200,
"minLength": 3,
"title": "Title",
"type": "string"
},
"description": {
"description": "What the user asked for, what you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.",
"maxLength": 5000,
"minLength": 10,
"title": "Description",
"type": "string"
},
"app": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "App slug the report is about, e.g. 'skool', or for a site in the web browser its host, e.g. 'app.example.com'.",
"title": "App"
},
"tool": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Tool or endpoint name, e.g. 'skool_list_members'.",
"title": "Tool"
},
"call_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "call_id of the call that went wrong, if any.",
"title": "Call Id"
},
"client": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Agent or tool sending this, e.g. 'Claude Code'.",
"title": "Client"
}
},
"required": [
"kind",
"title",
"description"
],
"additionalProperties": false,
"description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
"title": "AgentReportCreate"
}
cotlet_browser_open
Wakes the user's Tradify Cloud Browser, a real Chrome hosted on Cotlet and signed in to Tradify as the user. Use it for what the Tradify tools do not cover. Opens `url` when given and returns the page's URL, title and tab. In the web browser `url` opens in the open tab of the same site, else in a new tab when the shown tab already has a site open (at the tab limit in the tab you opened and used longest ago), so the user's other apps stay as they are (the tabs tool lists them). The user watches every step live. Before the first step in an app, Cotlet's app guide says which browser to use and how to work in the app. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
url
string
optional
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"additionalProperties": false
}
cotlet_browser_navigate
Opens a public http or https address in the user's Tradify Cloud Browser and returns the URL and title it ended on. Only Tradify pages open. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
url
string
required
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"required": [
"url"
],
"additionalProperties": false
}
cotlet_browser_read
Returns the current page of the user's Tradify Cloud Browser: its readable text, up to 20,000 characters, and a numbered list of its links, buttons, fields, options and toggles, also inside frames. Open dialogs and cookie banners come first: they cover the page, so close or answer them first. Field values, cookies and storage are never returned. On a page longer than that, both start near where it is scrolled to; `element` reads only the part inside that element (a dialog, a form, a list). Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters1
element
integer
optional
Read only inside this element of the last read.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "Read only inside this element of the last read."
}
},
"additionalProperties": false
}
cotlet_browser_screenshot
Returns a JPEG image of the visible part of the current page in the user's Tradify Cloud Browser, with its URL and title: boards, canvases and layouts that the page text does not show. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Scrolls the current page in the user's Tradify Cloud Browser with the mouse wheel, as a person does: down or up by `screens` viewport heights (default 0.8), to the top or the bottom, or until element `element` is in view. Content that loads on scroll appears, and the next read lists it. Returns the URL, title and scroll position (at_top, at_bottom). Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
direction
string
optional
Where to scroll. Default: down.
screens
number
optional
How far, in viewport heights, for down and up. Default: 0.8.
element
integer
optional
Scroll until this element of the element list is in view.
inside
integer
optional
Scroll inside this element (a list in a dialog or a side panel), not the page.
Raw schema
{
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"down",
"up",
"top",
"bottom"
],
"description": "Where to scroll. Default: down."
},
"screens": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10,
"description": "How far, in viewport heights, for down and up. Default: 0.8."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Scroll until this element of the element list is in view."
},
"inside": {
"type": "integer",
"minimum": 1,
"description": "Scroll inside this element (a list in a dialog or a side panel), not the page."
}
},
"additionalProperties": false
}
cotlet_browser_click
Clicks a link, button, option or other element of the current page in the user's Tradify Cloud Browser, by its number in the page's element list, or a point of the screenshot (`x`, `y`) for boards, canvases and maps. Returns the URL and title after the click, and says when nothing on the page changed. It acts as the user on that site. Buttons that pay or buy and buttons on account or sign-in pages are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters6
element
integer
optional
The element's number in the element list of the current page.
x
number
optional
Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps).
y
number
optional
With `x`: pixels from the top of the screenshot.
double
boolean
optional
Double-click.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
},
"double": {
"type": "boolean",
"description": "Double-click."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
}
cotlet_browser_type
Types text into a field of the current page in the user's Tradify Cloud Browser, by the field's number in the page's element list, and with `submit` presses Enter. Returns the URL and title after it. Password, card and one-time code fields and sign-in pages are refused: the user fills those in themselves. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters6
element
integer
required
The element's number in the element list of the current page.
text
string
required
The text to type.
submit
boolean
optional
Press Enter after typing, e.g. to search.
slowly
boolean
optional
Type key by key: for a search or address field whose suggestions do not appear. Read after it; the suggestions are listed as options to click.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"text": {
"type": "string",
"maxLength": 5000,
"description": "The text to type."
},
"submit": {
"type": "boolean",
"description": "Press Enter after typing, e.g. to search."
},
"slowly": {
"type": "boolean",
"description": "Type key by key: for a search or address field whose suggestions do not appear. Read after it; the suggestions are listed as options to click."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"element",
"text"
],
"additionalProperties": false
}
cotlet_browser_select
Chooses an option of a drop-down list on the current page in the user's Tradify Cloud Browser, by the list's number in the element list and the option's label as read lists it (or its value). Returns the URL and title after it. Card fields and account pages are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
element
integer
required
The element's number in the element list of the current page.
option
string
required
The option.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"option": {
"type": "string",
"maxLength": 300,
"description": "The option."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"element",
"option"
],
"additionalProperties": false
}
cotlet_browser_press
Presses a key on the current page in the user's Tradify Cloud Browser, on the element that has focus: Tab to the next field, Enter to send, Escape to close a dialog or pop-up, arrows to move through a suggestion list or a slider, or one character (a site's shortcut). Returns the URL and title after it, and says when nothing changed. Enter on account pages and characters into password fields are refused. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
key
string
required
One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or a single character such as a or 5.
repeat
integer
optional
Press it this many times, e.g. ArrowDown 3 times. Default 1.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"key": {
"type": "string",
"anyOf": [
{
"enum": [
"Enter",
"Tab",
"Shift+Tab",
"Escape",
"Backspace",
"Delete",
"Space",
"ArrowDown",
"ArrowUp",
"ArrowLeft",
"ArrowRight",
"PageDown",
"PageUp",
"Home",
"End"
]
},
{
"pattern": "^[ -~]$"
}
],
"description": "One of Enter, Tab, Shift+Tab, Escape, Backspace, Delete, Space, ArrowDown, ArrowUp, ArrowLeft, ArrowRight, PageDown, PageUp, Home, End, or a single character such as a or 5."
},
"repeat": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Press it this many times, e.g. ArrowDown 3 times. Default 1."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"key"
],
"additionalProperties": false
}
cotlet_browser_upload
Puts files into a file field of the current page in the user's Tradify Cloud Browser, or into the file picker that an upload button opens, by its number in the element list. A file is given as {"url": "https://..."} for a file online or {"file_id": "..."} for one uploaded to Cotlet first; up to 10 files, 20 MB each. Returns the URL and title after it. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters2
element
integer
required
The element's number in the element list of the current page.
files
array
required
The files.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"files": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public file URL."
},
"file_id": {
"type": "string",
"description": "A file uploaded to Cotlet."
}
},
"additionalProperties": false
},
"description": "The files."
}
},
"required": [
"element",
"files"
],
"additionalProperties": false
}
cotlet_browser_back
Goes back one page in the user's Tradify Cloud Browser, like the browser's Back button (with `forward`, forward again). Returns the URL and title. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters3
forward
boolean
optional
Go forward instead of back.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"forward": {
"type": "boolean",
"description": "Go forward instead of back."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"additionalProperties": false
}
cotlet_browser_hover
Rests the pointer on an element of the current page (or a point of the screenshot) in the user's Tradify Cloud Browser, as a person does to open a hover menu, a tooltip or a card's preview. Read after it for what opened. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters3
element
integer
optional
The element's number in the element list of the current page.
x
number
optional
Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps).
y
number
optional
With `x`: pixels from the top of the screenshot.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false
}
cotlet_browser_drag
Drags from one element or point of the screenshot to another in the user's Tradify Cloud Browser: a piece on a board, a card between columns, a field into a form builder, a slider's handle. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Parameters4
from
object
required
An element number, or x and y of the screenshot.
to
object
required
An element number, or x and y of the screenshot.
dialog
string
optional
How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog.
dialog_text
string
optional
Text for a prompt dialog this step opens; implies accept.
Raw schema
{
"type": "object",
"properties": {
"from": {
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false,
"description": "An element number, or x and y of the screenshot."
},
"to": {
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"x": {
"type": "number",
"minimum": 0,
"description": "Instead of `element`: pixels from the left of the screenshot (boards, canvases, maps)."
},
"y": {
"type": "number",
"minimum": 0,
"description": "With `x`: pixels from the top of the screenshot."
}
},
"additionalProperties": false,
"description": "An element number, or x and y of the screenshot."
},
"dialog": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "How to answer a native dialog (confirm, prompt, 'leave this page?') this step opens: accept presses OK, dismiss presses Cancel. Default: OK for an alert, Cancel for every other dialog."
},
"dialog_text": {
"type": "string",
"maxLength": 1000,
"description": "Text for a prompt dialog this step opens; implies accept."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
cotlet_browser_wait
Waits until `text` shows on the current page in the user's Tradify Cloud Browser (at most `seconds`, default 5, up to 20), or just `seconds` without text: for results, prices or a page that load slowly. Says whether the text appeared. Run browser steps one at a time and wait for each answer; steps sent together run in no set order. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in the browser.
Ends the session in the user's Tradify Cloud Browser: the browser keeps its cookies, goes to sleep and the per-minute charge stops. Returns the session's minutes and credits.
How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's dedicated tools when Cotlet has them. Call it before the first browser step in an app. Works for any web app; one outside Cotlet's catalog gets the general method. Free, no browser session.
Parameters2
app
string
optional
The app's name or Cotlet slug. Default: Tradify.
task
string
optional
What the user wants done in the app, in their words.
Raw schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"maxLength": 120,
"description": "The app's name or Cotlet slug. Default: Tradify."
},
"task": {
"type": "string",
"maxLength": 500,
"description": "What the user wants done in the app, in their words."
}
},
"additionalProperties": false
}
get_customer
Customer profile with sites, notes, latest jobs, quotes and invoices, and the balance due. Returns one customer: contact, email, phone, address, sites and notes, plus the latest 25 jobs, quotes and invoices with their totals (job_count, quote_count and invoice_count give the full numbers; list_jobs, list_quotes and list_invoices page through more). balance_due adds up what is due on the approved invoices returned.
Full invoice: lines, tax, totals, every payment with date and method, amount due, jobs and quote. Returns one invoice: status (draft, approved, overdue, paid, cancelled), customer, its jobs, the quote it came from and how (entire_quote, quote_line_items, percentage, fixed, remaining), reference, description, invoice and due dates, whether it was sent, its lines, subtotal, tax, total, paid, credited and due, and each payment with date, amount, method and reference.
Full job: description, site, tasks, notes, appointments, costs, linked quotes and invoices. Returns one job: customer, contact, site address, status, reference and description, the staff on it, its tasks and notes, the Scheduler appointments (times with the company's UTC offset), the costs logged on it (products and misc costs), the time logged on it (timesheets) and the quotes and invoices linked to it. Read it before changing a job.
Full quote: lines with price and cost, tax, totals, gross profit, dates and invoices made from it. Returns one quote: status (draft, awaiting_acceptance, accepted, declined, cancelled, expired), customer, job, reference, description, quote, expiry and acceptance dates, its lines (item, time, misc or kit, with quantity, unit price, unit cost, tax rate and amount), subtotal, tax, total, cost and gross profit, and the invoices made from it so far.
Job profitability, job sheet, staff productivity or timesheet report for a period, as rows. Runs one report of Tradify's Reports page for the days from to to (both included, at most a year) and returns the rows of its CSV download, amounts as numbers. job_profitability gives three rows per job (Time, Materials, Total) with estimated cost from quotes, actual cost, invoiced, to invoice, gross profit and margin. job_sheet lists the jobs with site, staff, schedule, contacts, entered by and on. staff_productivity gives billable, non-billable and total hours (h:mm) per staff member. timesheets lists each time entry with job, customer, staff member, billing rate, notes, date and hours. date_basis picks jobs by entry or by schedule date. Stops at 1000 rows with truncated true.
Parameters7
to
string
required
Last day of the period, up to a year after from.
from
string
required
First day of the period.
staff
string
optional
Only this staff member, by full name.
report
string
required
job_profitability (estimated and actual cost, invoiced, to invoice, gross profit and margin per job, split into time and materials), job_sheet (jobs with site, staff, schedule, contacts, labour and cost), staff_productivity (billable and non-billable hours per staff member) or timesheets (time logged per job and staff member).
date_basis
string
optional
job_profitability and job_sheet: jobs entered in the period (default) or scheduled in it.
customer_id
string
optional
job_profitability, job_sheet, timesheets: only this customer (list_customers).
include_inactive_jobs
boolean
optional
job_sheet: also complete and cancelled jobs.
Raw schema
{
"type": "object",
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Last day of the period, up to a year after from."
},
"from": {
"type": "string",
"format": "date",
"description": "First day of the period."
},
"staff": {
"type": "string",
"description": "Only this staff member, by full name."
},
"report": {
"enum": [
"job_profitability",
"job_sheet",
"staff_productivity",
"timesheets"
],
"type": "string",
"description": "job_profitability (estimated and actual cost, invoiced, to invoice, gross profit and margin per job, split into time and materials), job_sheet (jobs with site, staff, schedule, contacts, labour and cost), staff_productivity (billable and non-billable hours per staff member) or timesheets (time logged per job and staff member)."
},
"date_basis": {
"enum": [
"entered",
"scheduled"
],
"type": "string",
"default": "entered",
"description": "job_profitability and job_sheet: jobs entered in the period (default) or scheduled in it."
},
"customer_id": {
"type": "string",
"description": "job_profitability, job_sheet, timesheets: only this customer (list_customers)."
},
"include_inactive_jobs": {
"type": "boolean",
"default": false,
"description": "job_sheet: also complete and cancelled jobs."
}
},
"required": [
"report",
"from",
"to"
],
"additionalProperties": false
}
list_appointments
Scheduler appointments in a date range, with staff, job, times and notes. Returns the Scheduler's job appointments that fall between from and to (both days included, at most 31 days), each with its job, customer, staff member, start and end (ISO 8601 with the company's UTC offset), notes and status (accepted, unconfirmed, declined, cancelled). staff keeps only those people, by full name.
Parameters3
to
string
required
Last day, up to 31 days after from.
from
string
required
First day.
staff
array
optional
Only these staff members, by full name.
Raw schema
{
"type": "object",
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Last day, up to 31 days after from."
},
"from": {
"type": "string",
"format": "date",
"description": "First day."
},
"staff": {
"type": "array",
"items": {
"type": "string"
},
"description": "Only these staff members, by full name."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
list_customers
Customer profiles with contact details and sites. Lists customers by name with contact, email (may be a comma list), phone, mobile, physical address and sites. search matches name, contact, email or phone, so use it to find the customer_id before creating a job or quote. archived lists archived customers instead. Pass next_cursor back as cursor.
Invoices with customer, job, due date, total, amount paid and amount due. Lists invoices, newest first, with customer, jobs, invoice and due dates, total, paid and due (total minus payments and credits). status approved (default) is every approved invoice not fully paid; overdue is the ones past their due date; paid, draft, cancelled and all as named. customer_id lists that customer's invoices, and status then filters the page you get. Pass next_cursor back as cursor.
Parameters5
limit
integer
optional
cursor
string
optional
next_cursor from the previous call.
search
string
optional
Matches number, reference or customer.
status
string
optional
approved (sent, not fully paid; default), overdue, paid, draft, cancelled or all.
Jobs with number, customer, site address, status and assigned staff. Lists jobs, newest number first. By default only active jobs (every status marked active, built-in or custom); status all, a built-in status or the name of a custom status narrows it. customer_id lists that customer's jobs, and status then filters the page you get. Pass next_cursor back as cursor.
Parameters5
limit
integer
optional
cursor
string
optional
next_cursor from the previous call.
search
string
optional
Matches job number, customer or reference.
status
string
optional
active (default), all, unassigned, assigned, scheduled, in_progress, to_invoice, on_hold, complete, cancelled or the name of a custom status.
customer_id
string
optional
Only this customer's jobs (list_customers).
Raw schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous call."
},
"search": {
"type": "string",
"description": "Matches job number, customer or reference."
},
"status": {
"type": "string",
"description": "active (default), all, unassigned, assigned, scheduled, in_progress, to_invoice, on_hold, complete, cancelled or the name of a custom status."
},
"customer_id": {
"type": "string",
"description": "Only this customer's jobs (list_customers)."
}
},
"required": [],
"additionalProperties": false
}
list_quotes
Quotes with customer, total, quote date, expiry date and status. Lists quotes, newest quote date first, with customer, linked job, total (with tax), quote, expiry and accepted dates and status. By default the quotes awaiting acceptance; expired is the ones awaiting acceptance past their expiry date. since keeps quotes dated on or after that day, so use status accepted with since to find what was won in a period. Pass next_cursor back as cursor.
Parameters5
limit
integer
optional
since
string
optional
Only quotes dated on or after this day.
cursor
string
optional
next_cursor from the previous call.
search
string
optional
Matches number, reference or customer.
status
string
optional
awaiting_acceptance (default), draft, accepted, expired, cancelled, declined or all.
Timesheet entries in a date range: staff, job, customer, billing rate, hours, notes, invoiced. Returns the time entries between from and to (both days included, at most 62 days), oldest first, each with staff member, job and customer (none for time off a job), billing rate and whether it is billable, start and end (ISO 8601 with the company's UTC offset), hours, notes and whether it is on an invoice. staff and job_id narrow it. total_hours sums the entries returned.
Parameters4
to
string
required
Last day, up to 62 days after from.
from
string
required
First day.
staff
string
optional
Only this staff member, by full name.
job_id
string
optional
Only time on this job (list_jobs).
Raw schema
{
"type": "object",
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Last day, up to 62 days after from."
},
"from": {
"type": "string",
"format": "date",
"description": "First day."
},
"staff": {
"type": "string",
"description": "Only this staff member, by full name."
},
"job_id": {
"type": "string",
"description": "Only time on this job (list_jobs)."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}
add_job_note
Add a text note to a job's Notes tab. Adds a plain-text note to the job, signed with the signed-in user's name and today's date, as the Notes tab's New Note does. No staff member is notified and it reaches no one. get_job lists the notes.
New customer profile, optionally with contact details and a physical address. Creates an active customer with the company's default price group, document theme and tax settings, as the New Customer form does. email may hold several addresses separated by commas; quotes and invoices go there. It reaches no one and stays inside Tradify.
Draft invoice with its own line items, on a job or a customer. Nothing is sent until send_invoice. Creates a draft miscellaneous invoice, as New Invoice > Miscellaneous does, for a customer and optionally one of their jobs (job_id); no quote needed (for that, create_invoice_from_quote). Each line is misc (description, quantity, unit_price), time (hours at a billing rate) or price_list (item_code of a price list item); time and price list lines take the customer's price group price unless unit_price is given. Tax uses the default rate (a price list item's own rate), or tax_rate by name; tax_inclusive says whether prices include tax (default exclusive, or the job's setting). Reference and description default to the job's. theme picks a theme by name; terms sets the invoice terms (default the theme's). The due date follows the payment terms unless due_date is given. Kits are not supported. The invoice stays a draft until send_invoice.
Parameters10
terms
string
optional
Invoice terms. Default: the theme's invoice terms.
theme
string
optional
Theme name (Settings > Themes). Default: the customer's.
job_id
string
optional
Invoice this customer's job (list_jobs).
due_date
string
optional
Default: the payment terms.
reference
string
optional
Customer reference. Default: the job's.
line_items
array
required
customer_id
string
required
From list_customers or get_job.
description
string
optional
Shown on the invoice. Default: the job's.
invoice_date
string
optional
Default: today.
tax_inclusive
boolean
optional
Prices include tax. Default: the job's or customer's setting (tax exclusive).
Raw schema
{
"type": "object",
"properties": {
"terms": {
"type": "string",
"maxLength": 8000,
"description": "Invoice terms. Default: the theme's invoice terms."
},
"theme": {
"type": "string",
"maxLength": 255,
"description": "Theme name (Settings > Themes). Default: the customer's."
},
"job_id": {
"type": "string",
"description": "Invoice this customer's job (list_jobs)."
},
"due_date": {
"type": "string",
"format": "date",
"description": "Default: the payment terms."
},
"reference": {
"type": "string",
"maxLength": 255,
"description": "Customer reference. Default: the job's."
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"quantity"
],
"properties": {
"type": {
"enum": [
"misc",
"time",
"price_list"
],
"type": "string",
"default": "misc"
},
"quantity": {
"type": "number",
"description": "Units, or hours for time.",
"exclusiveMinimum": 0
},
"tax_rate": {
"type": "string",
"description": "Tax rate name, e.g. 'No Tax'. Default rate."
},
"item_code": {
"type": "string",
"minLength": 1,
"description": "price_list only: the price list item's code (or its exact description)."
},
"unit_cost": {
"type": "number",
"minimum": 0,
"description": "Quotes: your cost per unit. Default: 0."
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "Price per unit before tax. Required for misc; time and price_list default to the price list."
},
"description": {
"type": "string",
"maxLength": 4000,
"description": "Required for misc. Default for time: the rate's; for price_list: the item's."
},
"billing_rate": {
"type": "string",
"description": "Time only: billing rate name. Default rate."
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"customer_id": {
"type": "string",
"minLength": 1,
"description": "From list_customers or get_job."
},
"description": {
"type": "string",
"maxLength": 4000,
"description": "Shown on the invoice. Default: the job's."
},
"invoice_date": {
"type": "string",
"format": "date",
"description": "Default: today."
},
"tax_inclusive": {
"type": "boolean",
"description": "Prices include tax. Default: the job's or customer's setting (tax exclusive)."
}
},
"required": [
"customer_id",
"line_items"
],
"additionalProperties": false
}
create_invoice_from_quote
Draft invoice from an approved or accepted quote, for all of it or part of it. Creates a draft invoice from a quote, as Create Invoice > From Quote does, linked to the quote and its job. mode entire copies every line; line_items copies the lines at the positions in lines; percentage invoices amount percent of the quote total; fixed_amount invoices amount (with tax); remaining invoices what the quote's earlier invoices did not. A part is one line at the quote's tax rate. Due date follows the customer's or your payment terms. The invoice stays a draft until send_invoice. Needs a plan with progress invoicing (Pro) for the part modes.
Parameters4
mode
string
required
lines
array
optional
line_items: positions of the quote's lines to invoice, 1 for the first.
amount
number
optional
percentage: percent of the quote total (e.g. 50). fixed_amount: amount with tax.
quote_id
string
required
Quote ID from list_quotes.
Raw schema
{
"type": "object",
"properties": {
"mode": {
"enum": [
"entire",
"line_items",
"percentage",
"fixed_amount",
"remaining"
],
"type": "string"
},
"lines": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"description": "line_items: positions of the quote's lines to invoice, 1 for the first."
},
"amount": {
"type": "number",
"description": "percentage: percent of the quote total (e.g. 50). fixed_amount: amount with tax.",
"exclusiveMinimum": 0
},
"quote_id": {
"type": "string",
"minLength": 1,
"description": "Quote ID from list_quotes."
}
},
"required": [
"quote_id",
"mode"
],
"additionalProperties": false
}
create_job
New job for a customer. It starts as Unassigned. Creates a job for a customer, as New Job does, and Tradify gives it the next job number. It starts Unassigned; schedule_appointment books staff on it. Contact, phone and site address default to the customer's. It reaches no one and stays inside Tradify.
Draft quote with line items. Nothing is sent until you call send_quote. Creates a draft quote for a customer, as New Quote does. Each line is misc (description, quantity, unit_price), time (hours at a billing rate) or price_list (item_code of a price list item); time and price list lines take the customer's price group price unless unit_price is given. Tax uses the default rate (a price list item's own rate), or tax_rate by name; amounts, tax and totals are worked out as Tradify does. job_id links it to a job of the same customer. theme picks a theme by name (default the customer's); terms sets the quote terms (default the theme's). Expiry defaults to your expiry days setting. Kits are not supported. The quote stays a draft until send_quote.
Parameters9
terms
string
optional
Quote terms. Default: the theme's quote terms.
theme
string
optional
Theme name (Settings > Themes). Default: the customer's.
job_id
string
optional
Link the quote to this customer's job (list_jobs).
reference
string
optional
Customer reference.
line_items
array
required
customer_id
string
required
From list_customers or create_customer.
description
string
optional
Shown on the quote.
expiry_date
string
optional
Default: your expiry days setting.
tax_inclusive
boolean
optional
Prices include tax.
Raw schema
{
"type": "object",
"properties": {
"terms": {
"type": "string",
"maxLength": 8000,
"description": "Quote terms. Default: the theme's quote terms."
},
"theme": {
"type": "string",
"maxLength": 255,
"description": "Theme name (Settings > Themes). Default: the customer's."
},
"job_id": {
"type": "string",
"description": "Link the quote to this customer's job (list_jobs)."
},
"reference": {
"type": "string",
"maxLength": 255,
"description": "Customer reference."
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"quantity"
],
"properties": {
"type": {
"enum": [
"misc",
"time",
"price_list"
],
"type": "string",
"default": "misc"
},
"quantity": {
"type": "number",
"description": "Units, or hours for time.",
"exclusiveMinimum": 0
},
"tax_rate": {
"type": "string",
"description": "Tax rate name, e.g. 'No Tax'. Default rate."
},
"item_code": {
"type": "string",
"minLength": 1,
"description": "price_list only: the price list item's code (or its exact description)."
},
"unit_cost": {
"type": "number",
"minimum": 0,
"description": "Quotes: your cost per unit. Default: 0."
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "Price per unit before tax. Required for misc; time and price_list default to the price list."
},
"description": {
"type": "string",
"maxLength": 4000,
"description": "Required for misc. Default for time: the rate's; for price_list: the item's."
},
"billing_rate": {
"type": "string",
"description": "Time only: billing rate name. Default rate."
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"customer_id": {
"type": "string",
"minLength": 1,
"description": "From list_customers or create_customer."
},
"description": {
"type": "string",
"maxLength": 4000,
"description": "Shown on the quote."
},
"expiry_date": {
"type": "string",
"format": "date",
"description": "Default: your expiry days setting."
},
"tax_inclusive": {
"type": "boolean",
"default": false,
"description": "Prices include tax."
}
},
"required": [
"customer_id",
"line_items"
],
"additionalProperties": false
}
log_time
Add a timesheet entry for a staff member, optionally on a job, with billing rate and notes. Adds one entry to Timesheets from start to end (same day, at most 24 hours) for a staff member (default the signed-in user), on a job or on none, at a billing rate (default the staff member's own) with the staff member's cost rate, as the New Timesheet Entry dialog does. Time on a job shows in its costs, the job profitability report and can be invoiced. It reaches no one.
Parameters6
end
string
required
Finish, the same day as start.
notes
string
optional
staff
string
optional
Staff member's full name. Default: you.
start
string
required
Start, ISO 8601; no zone = company time.
job_id
string
optional
The job the time was spent on (list_jobs). Default: no job.
billing_rate
string
optional
Billing rate name (e.g. Standard Labour Rate). Default: the staff member's own rate.
Raw schema
{
"type": "object",
"properties": {
"end": {
"type": "string",
"format": "date-time",
"description": "Finish, the same day as start."
},
"notes": {
"type": "string",
"maxLength": 2000
},
"staff": {
"type": "string",
"description": "Staff member's full name. Default: you."
},
"start": {
"type": "string",
"format": "date-time",
"description": "Start, ISO 8601; no zone = company time."
},
"job_id": {
"type": "string",
"description": "The job the time was spent on (list_jobs). Default: no job."
},
"billing_rate": {
"type": "string",
"description": "Billing rate name (e.g. Standard Labour Rate). Default: the staff member's own rate."
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
}
record_payment
Record a payment received against an invoice and reduce the amount due. Adds a payment you already received to an approved invoice, as Add Payment does: amount, date, method (by name, from Settings > Payment Methods) and a reference. It charges nobody and emails nobody. The amount cannot exceed what is due; paying it all marks the invoice paid. If an accounting app is connected, Tradify syncs the payment to it.
Parameters5
date
string
optional
Payment date. Default: today.
amount
number
required
Amount received, at most the amount due.
method
string
optional
Payment method name, e.g. Bank Deposit, Cash, Credit Card. Default: Unknown.
Book a job appointment on the Scheduler for staff, optionally emailing the customer a confirmation. Books the job on the Scheduler from start to end for each staff member named (by full name; default the signed-in user), as the Scheduler does. Each staff member gets Tradify's "You've been scheduled" notice, and an Unassigned or Assigned job becomes Scheduled. email_customer also sends the customer the appointment confirmation email, with customer_message in it. By default you confirm each call, and you can switch that off for this tool. Waits for the owner's approval.
Parameters7
end
string
required
ISO 8601; without a zone, company time.
notes
string
optional
Notes for the crew.
staff
array
optional
Staff member names, one appointment each. Default: you.
start
string
required
ISO 8601; without a zone, company time.
job_id
string
required
Job ID from list_jobs.
email_customer
boolean
optional
Email the customer a confirmation.
customer_message
string
optional
Extra text in that email.
Raw schema
{
"type": "object",
"properties": {
"end": {
"type": "string",
"format": "date-time",
"description": "ISO 8601; without a zone, company time."
},
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Notes for the crew."
},
"staff": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"description": "Staff member names, one appointment each. Default: you."
},
"start": {
"type": "string",
"format": "date-time",
"description": "ISO 8601; without a zone, company time."
},
"job_id": {
"type": "string",
"minLength": 1,
"description": "Job ID from list_jobs."
},
"email_customer": {
"type": "boolean",
"default": false,
"description": "Email the customer a confirmation."
},
"customer_message": {
"type": "string",
"maxLength": 2000,
"description": "Extra text in that email."
}
},
"required": [
"job_id",
"start",
"end"
],
"additionalProperties": false
}
send_invoice
Approve the invoice and email it to the customer, with payment reminders if enabled. Approves a draft invoice (Tradify gives it its number) and emails it from Tradify with the link to view and pay it; payment reminders follow if you enabled them. Without to it goes to the customer's email. Subject and text default to your invoice email template. An approved invoice can be sent again. Tradify sends this mail only when the login has 2-Step Security set up; otherwise the call stops before approving. By default you confirm each call, and you can switch that off for this tool. Waits for the owner's approval.
Parameters5
to
array
optional
Recipient emails. Default: the customer's email.
message
string
optional
Email text. Default: your invoice template.
subject
string
optional
Default: your invoice email template.
invoice_id
string
required
Invoice ID from list_invoices or create_invoice_from_quote.
Approve the quote and email it to the customer with a link to accept or decline online. Approves a draft quote (it becomes awaiting acceptance) and emails it from Tradify with the link where the customer accepts or declines it online. Without to it goes to the customer's email. Subject and text default to your quote email template. An approved quote can be sent again. Tradify sends this mail only when the login has 2-Step Security set up; otherwise the call stops before approving. By default you confirm each call, and you can switch that off for this tool. Waits for the owner's approval.
Set a status on a job, built-in or one of your custom statuses. Sets a job's status, as Change Status on the Jobs list does: to_invoice, on_hold, complete, cancelled, the others of the built-in list, or the name of a custom status from Settings > Jobs > Job Statuses (spaces as underscores). It reaches no one, and one more call sets it back.
Parameters2
job_id
string
required
Job ID from list_jobs.
status
string
required
unassigned, assigned, scheduled, in_progress, to_invoice, on_hold, complete, cancelled or the name of a custom status.
Raw schema
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 1,
"description": "Job ID from list_jobs."
},
"status": {
"type": "string",
"minLength": 1,
"description": "unassigned, assigned, scheduled, in_progress, to_invoice, on_hold, complete, cancelled or the name of a custom status."
}
},
"required": [
"job_id",
"status"
],
"additionalProperties": false
}
Tradify API and MCP server: connect Tradify to ChatGPT and Claude
Yes, ChatGPT, Claude and other AI agents can work in your Tradify account. That includes Cursor, Codex, OpenClaw and any MCP client, plus automations in n8n, Make and Zapier. Ask in plain words, and the AI creates the job, writes the quote, turns it into an invoice, records the payment and books your staff. It shows you the draft first and sends nothing to a customer until you say so.
Tradify has no public API, no API keys and no official MCP server. As of November 2026, this repo is the missing piece: 22 Tradify tools for AI assistants and scripts.
What you can ask
New job for Sam Lee at 12 Oak St: replace the hot water cylinder. Book Mike for Thursday morning and email Sam the confirmation.
Quote the bathroom rewire at 14 Elm Rd from my notes: 6 hours labour, 6 LED downlights at $24, one extractor fan at $85. Show me before you send it.
Turn every quote accepted this week into a 30% deposit invoice.
Which invoices are overdue? Total them per customer, oldest first.
Record the bank transfers I paste below against their invoices.
A Tradify API and a Tradify MCP server you run on your own computer, in Python, on the session of your own Google Chrome. All 22 Tradify tools we run in production at Cotlet: jobs, job status and notes, customers, quotes with line items, invoices from quotes, quote and invoice email, payments, the Scheduler, reports and timesheets.
Tradify's accounting connectors (Xero, QuickBooks, Sage) sync invoices and bills, not jobs, quotes or the schedule. This repo gives you:
MCP server for Claude Code, Claude Desktop, Cursor, Codex and any MCP client, over stdio or HTTP. Setup
REST API on http://127.0.0.1:8787/api/v1/tradify, with OpenAPI docs at /docs. Setup
Python: call("list_invoices", {"status": "overdue"}), plus 9 ready scripts in examples/.
Free for your own use, your own trade business included (license).
Does Tradify have an API?
Not a public one. Tradify offers no public API, no self-service API keys and no webhooks, only its built-in integrations (Xero, QuickBooks, MYOB, Sage, Stripe, Google Calendar). This repo and Cotlet give you the missing Tradify API: 22 tools for jobs, customers, quotes, invoices, payments, the Scheduler, reports and timesheets, as a REST API and an MCP server.
Can I get a Tradify API key?
Not from Tradify. With Cotlet you get your own API key that works with your Tradify account, for scripts, n8n, Make, Zapier or any HTTP client. This repo needs no key: it runs on your computer, on your own Tradify session.
Is there an official ChatGPT integration for Tradify?
No. Tradify has no official ChatGPT or Claude connector. Cotlet is an unofficial one that works today, in the ChatGPT and Claude apps and in any AI agent that takes an MCP server.
How do I connect Tradify to ChatGPT?
Sign up at cotlet.dev, sign in to Tradify once in your Cloud Browser there, and add Cotlet to ChatGPT, following the steps in your account. Then ask ChatGPT about your jobs, quotes and invoices like you would ask your office manager. ChatGPT needs a server on the internet, so this repo alone, running on your computer, does not connect to ChatGPT.
Why Zapier, n8n and webhooks can't do this for Tradify, and what an AI receptionist can do once it's connected: How to connect Tradify to ChatGPT when there is no API, no Zapier and no webhook.
Can ChatGPT create quotes in Tradify for me?
Yes, with Cotlet. Give it your notes, and it writes a draft quote in Tradify with labour and materials lines, shows it to you, and sends it to the customer only after your OK. The same works in Claude, Cursor, Codex and other AI agents.
Can AI do my Tradify invoices?
Yes, with Cotlet connected to ChatGPT, Claude or another AI agent. It turns an accepted quote into an invoice, in full or as a deposit, sends it after your OK, records payments you paste from your bank and lists what is overdue. The invoices are real Tradify invoices, so they still sync to Xero or QuickBooks the way you set it up.
Tradify has SmartWrite. What does this add?
SmartWrite helps you word a description. With Cotlet, the AI does the work in your account: it creates the job, the quote and the invoice, books staff on the Scheduler and records payments.
Does Tradify work with Zapier or Make?
Tradify has no Zapier or Make app. Through Cotlet it does: n8n, Make and Zapier can create jobs, customers and quotes in Tradify, for example from a web form, an email or a WhatsApp enquiry.
Can I use it from my phone, on site?
Yes, with Cotlet: once Tradify is connected, the ChatGPT and Claude apps on your phone can use it. Ask for tomorrow's schedule, a new job for a caller or the balance of a customer, without opening Tradify.
Do I need to be technical?
For Cotlet, no: you sign in to Tradify and add Cotlet to ChatGPT or Claude, with step-by-step instructions in your account. This repo is for people who are fine with Python and a terminal.
Is my Tradify account safe?
Yes. Neither Cotlet nor this repo sees or stores your Tradify password. You sign in yourself, the way you always do, and the AI works on that signed-in session. Anything that reaches a customer, like a sent quote or invoice, asks for your OK first: in Cotlet by default, here through your MCP client.
Is it free?
This repo is free, also in your own trade business. Cotlet is free for 7 days with no card, then one-time credit packs from $29, no subscription. Pricing.
I run Tradify for several companies or clients. Does that work?
Yes. Each Tradify login gets its own connection. Write to contact@cotlet.dev and tell us how many accounts you manage.
How it works
text
AI agent (MCP) / script (REST, Python) ──▶ tradify-mcp on your computer ──your cookies──▶ go.tradifyhq.com
▲
tradify-mcp connect ──────┘ reads them once from your Chrome (DevTools Protocol)
You sign in to Tradify in your own Chrome at go.tradifyhq.com, the way you always do: username, Continue, password. Tick Keep me logged in.
tradify-mcp connect attaches to that Chrome through the Chrome DevTools Protocol, reads the tradifyhq.com cookies and saves them to ~/.config/tradify-api-mcp/session.json, readable by your user only. It never sees or stores your password or a 2-Step code.
Every tool call is a request to the /api the Tradify web app itself calls, with those cookies, sent with curl_cffi, which copies Chrome's TLS fingerprint. Calls that change something carry the app's antiforgery token, read fresh for each tool run. No headless browser runs.
The session lives in one cookie, SessionId. With Keep me logged in Tradify keeps it for about a month. When Tradify signs you out, the server reads the cookies from Chrome again, if Chrome is open with remote debugging on.
Requirements
Python 3.11 or newer.
Google Chrome 144 or newer, signed in to go.tradifyhq.com. Any Chrome or Chromium works with a debugging port.
macOS, Linux or Windows.
A Tradify account. We build and test with the company owner. An office user sees and does what Tradify lets that user do. send_quote and send_invoice need 2-Step Security on the login (Settings > Security), because Tradify blocks quote and invoice email without it.
With uv: uv venv && uv pip install -e ., then uv run tradify-mcp ....
Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: AGENTS.md tells it every step, and it asks you only for the steps in Chrome.
To update: uv tool upgrade tradify-api-mcp (or pip install -U tradify-api-mcp), from source git pull && pip install -e .. We copy every change of the hosted Tradify tools into this repo.
Connect your Chrome
Option A: your everyday Chrome (recommended)
Open chrome://inspect/#remote-debugging in Chrome and switch remote debugging on. Chrome then accepts DevTools connections from programs on this computer, and asks you before each one.
Chrome asks whether to allow the connection. Click Allow.
text
Saved 6 Tradify cookies to /Users/you/.config/tradify-api-mcp/session.json
Signed in to Tradify as Dan Novak (Northside Plumbing)
You can switch remote debugging off again afterwards. Leave it on if you want the server to pick up a new session by itself after Tradify signs you out.
connect looks for Chrome's DevToolsActivePort file in the default profile folder. For Chrome Beta, Canary or a custom profile folder, pass --profile-dir "<folder>".
Option B: a Chrome with a debugging port
Chrome does not open a debugging port on your default profile, so start a separate one, sign in to Tradify there once, and connect to it:
A fresh profile is a new device to Tradify, so with 2-Step Security on it asks for a code at sign-in. --cdp also takes a ws:// DevTools URL, for example of a Chrome on another machine reached over an SSH tunnel.
Option C: paste the cookie by hand
For a server with no Chrome: in Chrome open DevTools on go.tradifyhq.com, Application > Cookies > https://go.tradifyhq.com, copy the value of SessionId, then:
bash
tradify-mcp connect --token # paste it, input is hidden# or, without a session file:export TRADIFY_AUTH_TOKEN=...
A pasted cookie is not read again from Chrome. Paste a new one when Tradify signs you out.
Check the session at any time:
bash
tradify-mcp status
MCP server
The MCP server lists every tool with its input schema, a description written for agents, and hints. Read tools are marked read-only, and the tools that reach other people (quote and invoice email, Scheduler bookings) are marked so your client asks before running them.
Claude Code
bash
claude mcp add tradify -- uvx tradify-api-mcp mcp
# read only:
claude mcp add tradify -- uvx tradify-api-mcp mcp --read-only
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
tradify-mcp serve also serves MCP over streamable HTTP at http://127.0.0.1:8787/mcp, for clients that take a URL:
bash
tradify-mcp serve
claude mcp add --transport http tradify http://127.0.0.1:8787/mcp
Then ask your agent things like:
New job for Sam Lee at 12 Oak St: replace the hot water cylinder. Book Mike Ross for Thursday morning, about four hours, and email Sam the confirmation.
Quote the bathroom rewire at 14 Elm Rd from my notes: 6 hours on the Standard billing rate, 6 LED downlights at $24 each, one extractor fan at $85. Show me the draft before you send it.
For every quote accepted this week, create a 30% deposit invoice, skip anything under $500 or already invoiced, and send them after I check the list.
Record the bank transfers I paste below against their invoices, then list every invoice still overdue, totalled per customer, oldest first.
REST API
bash
tradify-mcp serve # http://127.0.0.1:8787, MCP at /mcp, docs at /docs
Each tool has its own route under /api/v1/tradify, the same paths as the hosted API at cotlet.dev, so code written against one works with the other. Path parts and the query string are arguments, and a JSON body adds the rest.
curl -X POST http://127.0.0.1:8787/api/v1/tradify/tools/list_customers -d '{"search": "lee"}'
GET /api/v1/tradify/tools: every tool with its route, input schema and an example answer.
GET /docs: interactive OpenAPI docs, GET /openapi.json the schema, for n8n, Postman or a generated client.
Answers are JSON. List tools return next_cursor; pass it back as cursor for the next page.
The server listens on 127.0.0.1 only. To reach it from another device of yours, set a token, and every request then needs Authorization: Bearer <token>:
Or one tool from the shell: tradify-mcp call list_quotes status=accepted since=2026-10-01, or with a JSON object.
Times are wall clock in your company's time zone (Settings > Company). 2026-10-29T08:00 means 8:00 there. A time with an offset is converted to it, and answers carry the company's offset.
Ready scripts in examples/. Each prints a short list or JSON, takes --out file.csv or --out file.json where it makes sense, and --help. The ones that change Tradify only show their plan until you pass --apply or --send:
On a schedule, cron on your own computer works while it is on: 0 18 * * * cd ~/tradify-api-mcp-server && .venv/bin/python examples/tomorrows_schedule.py.
All 22 tools
IDs come from the list tools: job_id from list_jobs, customer_id from list_customers, quote_id from list_quotes, invoice_id from list_invoices. Staff are named by full name, as on the Scheduler. tradify-mcp tools prints this list, tradify-mcp tools --json adds the input schemas.
Jobs
Tool
Access
REST route
What it does
list_jobs
read
GET /jobs
Jobs with number, customer, site address, status and assigned staff.
get_job
read
GET /jobs/{job_id}
Full job: description, site, tasks, notes, appointments, costs, linked quotes and invoices.
create_job
write
POST /customers/{customer_id}/jobs
New job for a customer. It starts as Unassigned.
update_job_status
write
PATCH /jobs/{job_id}/status
Set a status on a job, built-in or one of your custom statuses.
add_job_note
write
POST /jobs/{job_id}/notes
Add a text note to a job's Notes tab. It notifies no one.
Customers
Tool
Access
REST route
What it does
list_customers
read
GET /customers
Customer profiles with contact details and sites.
get_customer
read
GET /customers/{customer_id}
Customer profile with sites, notes, latest jobs, quotes and invoices, and the balance due.
create_customer
write
POST /customers
New customer profile, optionally with contact details and a physical address.
Quotes
Tool
Access
REST route
What it does
list_quotes
read
GET /quotes
Quotes with customer, total, quote date, expiry date and status.
get_quote
read
GET /quotes/{quote_id}
Full quote: lines with price and cost, tax, totals, gross profit, dates and invoices made from it.
create_quote
write
POST /customers/{customer_id}/quotes
Draft quote with line items. Nothing is sent until you call send_quote.
send_quote
write
POST /quotes/{quote_id}/send
Approve the quote and email it to the customer with a link to accept or decline online.
Invoices and payments
Tool
Access
REST route
What it does
list_invoices
read
GET /invoices
Invoices with customer, job, due date, total, amount paid and amount due.
get_invoice
read
GET /invoices/{invoice_id}
Full invoice: lines, tax, totals, every payment with date and method, amount due, jobs and quote.
create_invoice_from_quote
write
POST /quotes/{quote_id}/invoices
Draft invoice from an approved or accepted quote, for all of it or part of it.
send_invoice
write
POST /invoices/{invoice_id}/send
Approve the invoice and email it to the customer, with payment reminders if enabled.
record_payment
write
POST /invoices/{invoice_id}/payments
Record a payment received against an invoice and reduce the amount due.
Scheduler
Tool
Access
REST route
What it does
list_appointments
read
GET /appointments
Scheduler appointments in a date range, with staff, job, times and notes.
schedule_appointment
write
POST /jobs/{job_id}/appointments
Book a job appointment on the Scheduler for staff, optionally emailing the customer a confirmation.
Reports and timesheets
Tool
Access
REST route
What it does
get_report
read
GET /reports/{report}
Job profitability, job sheet, staff productivity or timesheet report for a period, as rows.
list_timesheets
read
GET /timesheets
Timesheet entries in a date range: staff, job, customer, billing rate, hours, notes, invoiced.
log_time
write
POST /timesheets
Add a timesheet entry for a staff member, optionally on a job, with billing rate and notes.
send_quote and send_invoice email the customer. schedule_appointment sends each staff member Tradify's "You've been scheduled" notice, and emails the customer only with email_customer. The other write tools stay inside Tradify. Drafts from create_quote and create_invoice_from_quote reach nobody. record_payment refuses more than the amount due and a draft invoice. Part invoices from a quote (percentage, fixed_amount, line_items) need a plan with progress invoicing, which Tradify sells as Pro.
Not in this version: price list items, kits and quote options (quotes take misc and time lines), editing or deleting a quote, invoice or customer, editing or deleting a time entry, moving or cancelling an appointment, report PDFs, job tasks and attachments, bills, purchase orders, enquiries, recurring jobs and forms.
Never built, on purpose: your Tradify sign-in, password and 2-Step Security, and your Tradify plan and billing. Every request passes a guard that refuses any change to the sign-in and account paths of the web app.
Configuration
Variable
Default
What it does
TRADIFY_MCP_HOME
~/.config/tradify-api-mcp
Folder of session.json.
TRADIFY_AUTH_TOKEN
The SessionId cookie value, used instead of session.json.
TRADIFY_PROXY
Proxy for every request to Tradify, e.g. http://user:pass@host:port.
TRADIFY_MCP_READ_ONLY
1 hides and refuses every tool that changes Tradify (same as --read-only).
TRADIFY_MCP_TOKEN
Bearer token required by serve; needed to listen beyond 127.0.0.1.
TRADIFY_MCP_HOST, TRADIFY_MCP_PORT
127.0.0.1, 8787
Address of serve.
Security and your Tradify account
Your password never reaches this code. Only the cookies Chrome already holds are read, and only those of tradifyhq.com.
The session file is yours.session.json is created with mode 0600. Anyone who has it can act as you in Tradify, so keep it out of git and shared folders.
Local by default.serve binds to 127.0.0.1 and refuses another address without TRADIFY_MCP_TOKEN.
tradifyhq.com only. Requests and redirects outside tradifyhq.com are refused.
Read-only mode.--read-only or TRADIFY_MCP_READ_ONLY=1 exposes the 6 read tools only.
Some actions reach real people. A sent quote or invoice lands in your customer's inbox and cannot be deleted in Tradify afterwards, only cancelled. MCP clients ask before running those tools; a script does not, so try it on a customer with your own email address first.
Errors
The REST API answers {"error": "<code>", "message": "..."}. The MCP server returns the same code and message as a tool error.
Status
Code
What to do
401
auth_required, auth_expired
No session, or Tradify signed you out. Sign in at go.tradifyhq.com in Chrome and run tradify-mcp connect.
403
app_permission_denied
Tradify does not let this login do it. For send_quote and send_invoice: set up 2-Step Security first.
403
scope_denied
The server runs read-only, or the request would change your Tradify sign-in.
403
target_blocked
Tradify refused the request or showed a bot check. Open the web app in Chrome once, then retry.
409
captcha_required
Tradify asks for a CAPTCHA. Solve it in Chrome.
422
invalid_input
An argument is missing or wrong; the message names it.
429
rate_limited
Tradify is limiting the account. Wait a few minutes.
502
target_error
Tradify answered with an error (its own message is in message when it gives one), or changed its web app. git pull for the latest tools, or open an issue.
your own Cloud Browser in the EU, profile encrypted with AES-256-GCM
When Tradify changes its web app
git pull once we have fixed it
fixed for you, every tool tested daily
Approvals
your MCP client asks per call
quote and invoice email and Scheduler bookings wait for your OK, switchable per tool
Works with
MCP clients on your machine, local scripts
Claude.ai and ChatGPT connectors, n8n, Make, Zapier, any HTTP client
Who may use it
you and your own business
you, teams, businesses, agencies
Price
free
free 7-day trial with 2,000 credits, no card; then one-time packs from $29 for 5,000 credits
On the hosted version a successful call uses 10 credits, failed calls are free, and the Cloud Browser uses 50 credits a day while it has an app enabled for agents. Full pricing.
FAQ
Is there a Tradify MCP server for Claude, ChatGPT or Cursor?
Yes, this one runs on your machine: tradify-mcp mcp for Claude Code, Claude Desktop, Cursor and Codex. ChatGPT and Claude.ai connectors need a public HTTPS URL, which the hosted Tradify MCP server gives you.
Can it get my Tradify jobs and invoices into another tool?
Yes. python examples/export_jobs.py --status all --out jobs.csv and python examples/overdue_invoices.py --out overdue.csv write CSV, and the REST API serves the same lists as JSON to n8n or any HTTP client.
Why does send_quote stop with app_permission_denied?
Tradify blocks quote and invoice email until the login has 2-Step Security. Set it up in Tradify under Settings > Security with a mobile number, then call again. The tool stops before it approves anything, so the quote or invoice stays a draft.
Which Tradify plan do I need?
The tools do what your plan lets you do in Tradify. Part invoices from a quote need progress invoicing, which Tradify sells as Pro. On the free Tradify Connect plan only the Scheduler works.
Does it work outside the US?
Yes. Tradify runs one web app for every country, and the tools read your company's time zone and tax rates from it.
Why does it need my Chrome?
To read your Tradify session without your password and without a 2-Step code. Chrome is used once per sign-in, not for each call.
What happens when Tradify signs me out?
Calls fail with auth_expired. With Chrome remote debugging on, the server reads the new session on the next call (click Allow when Chrome asks). Otherwise run tradify-mcp connect again.
Can it run on a VPS or in Docker?
Technically yes, with a pasted cookie or a session.json copied from your computer. Tradify then sees your session from a datacenter IP, which looks less like you. For an always-on setup the hosted version keeps your session in your own Cloud Browser on a fixed IP.
Will my Tradify account get banned?
Requests carry Chrome's fingerprint and go out one at a time, as you would click. Nobody can promise a platform never acts. Keep to your normal use.
Can I change the code or offer it to my clients?
You may change it and use it in your own business. You may not offer it to others as a hosted or managed service. For client work, use Cotlet or write to contact@cotlet.dev.
A tool broke or I need another one.Open an issue with the tool name and the error message.
Allowed: using it for yourself and in your own business, free. Changing the code and sharing it under the same license.
Not allowed: offering it to others as a hosted or managed service, removing the license notices, getting around its limits.
Maintained by Cotlet (@cotletdev). Tradify is a trademark of its owner. This project is unofficial and not affiliated with, endorsed or sponsored by Tradify.