Skip to main content
Glama
The Customer Factor MCP server

The Customer Factor MCP server

The Customer Factor MCP server

Connect The Customer Factor to ChatGPT, Claude and any AI agent through Cotlet.dev. Schedule recurring service jobs, find customers, create invoices and record payments in your own signed-in account. Invoices, reminders and crew messages ask for approval by default.

What you can ask

Set up a recurring service for a new customer.

Invoice completed jobs with tax and show me the totals before saving.

Find unpaid invoices and draft payment reminders for my approval.

Related MCP server: CrewNest MCP Server

Connect in 2 minutes

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

ChatGPT

Settings → Apps & Connectors → Create, with connector URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev. No API key needed.

Claude

Settings → Connectors → Add custom connector, with URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev.

Claude Code

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

Cursor

Copy .cursor/mcp.json from this repo into your project:

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

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its The Customer Factor tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Run the included Python module with Python 3.10 or later:

python3 the_customer_factor_agent.py serve

Or with Docker:

docker build -t the-customer-factor-mcp .
docker run -i --rm -e COTLET_API_KEY the-customer-factor-mcp

Tools: the_customer_factor_guide, the_customer_factor_status, the_customer_factor_open, the_customer_factor_read, the_customer_factor_click, the_customer_factor_type, the_customer_factor_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".

Command line

Python 3.10+, with no third-party runtime dependencies. Clone this repository and run:

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

Questions from The Customer Factor users

Which account should I connect?

Sign in with your own The Customer Factor account at www.thecustomerfactor.com/login in your Cotlet.dev Cloud Browser.

Does recording a payment charge a card?

No. The documented record_payment operation records an existing payment. Card processing stays in The Customer Factor payment window.

Is Cotlet affiliated with The Customer Factor?

No. Cotlet.dev is independent and not affiliated with The Customer Factor.

Learn more


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

Request access: https://cotlet.dev/signup?app=the-customer-factor&utm_source=github&utm_medium=readme&utm_campaign=the-customer-factor

Workflows on the hosted integration

The live integration page documents these service-business operations, selected from the live page:

  • find_customers

  • add_customer

  • add_prospect

  • convert_prospect

  • add_job_location

  • schedule_job

  • schedule_recurring_job

  • update_recurring_job

  • put_job_on_hold

  • mark_job_completed

  • manage_job_types

  • create_job_checklist

  • search_invoices

  • create_invoice

  • email_invoice

  • add_invoice_deposit

  • record_payment

  • email_payment_reminders

  • send_customer_statements

  • create_big_proposal

  • add_task

  • edit_specific_note

  • create_email_template

  • message_employees

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    • FieldEdge MCP server for ChatGPT, Claude and any AI agent: create work order, dispatch technician, list customers, send invoice and list unpaid invoices in your own FieldEdge account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to FieldEdge yourself; Cotlet does not store your password and you need no FieldEdge API key. About the official FieldEdge API: FieldEdge has an API, but only on request: customers ask for access through FieldEdge's onboarding form and get credentials for an app FieldEdge provisions (checked 8 Nov 2026). There are no self-service keys and no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/fieldedge-api-mcp-server

    • FieldRoutes MCP server for ChatGPT, Claude and any AI agent: schedule appointment, reschedule appointment, list customers, list unpaid tickets and add customer note in your own FieldRoutes account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to FieldRoutes yourself; Cotlet does not store your password and you need no FieldRoutes API key. About the official FieldRoutes API: FieldRoutes has a documented API, but keys come only through FieldRoutes support for each office, and the free tier allows 50 read requests a day per office (checked 8 Nov 2026). Webhooks need the Premium tier. Setup and FAQ: https://cotlet.dev/integrations/fieldroutes-api-mcp-server

    • ServiceTrade MCP server for ChatGPT, Claude and any AI agent: list jobs, create appointment, release appointment to technicians, list deficiencies, create quote, submit quote and add comment to job in your own ServiceTrade account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to ServiceTrade yourself; Cotlet does not store your password and you need no ServiceTrade API key. About the official ServiceTrade API: ServiceTrade has a full REST API with public docs and OAuth2 client-credentials sign-in, but no official MCP server (checked 23 Oct 2026). The API covers jobs, appointments, deficiencies and quotes, so the missing piece is the agent layer: you build and host the wrapper yourself. Setup and FAQ: https://cotlet.dev/integrations/servicetrade-api-mcp-server

    • Service Fusion MCP server for ChatGPT, Claude and any AI agent: create job, list customers, create estimate, create invoice and update job status in your own Service Fusion account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Service Fusion yourself; Cotlet does not store your password and you need no Service Fusion API key. About the official Service Fusion API: Service Fusion has an Open API, but only on the Pro plan, and it has no official MCP server (checked 11 Oct 2026). It lists and reads customers, jobs, estimates and invoices and creates customers, jobs and estimates. Setup and FAQ: https://cotlet.dev/integrations/service-fusion-api-mcp-server

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables ChatGPT, Claude, and other AI agents to draft estimates, schedule jobs, assign crew members, and review receivables in a user's signed-in business account, requiring approval before actions reach other people.
      7
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI agents to a signed-in contractor account through Cotlet.dev so they can work with estimates, leads, change orders, and job costs. Supports drafting line items, tracking estimate views, reading margins and recorded costs, and reviewing changes before writes are sent.
      Elastic 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to work with a signed-in Buildern contractor account through Cotlet.dev, including estimates, schedules, budgets, bills, client invoices, project to-dos, and site diaries, with review before write operations.
      Elastic 2.0