mcpField
C
Contractor+ MCP Server and API by Cotlet

Contractor+ MCP Server and API by Cotlet

Remote
cotlet.devBusiness & Marketing0Updated 3d ago

About Contractor+ MCP Server and API by Cotlet

An MCP server that connects AI agents to a signed-in Contractor+ account for contractor operations. It supports a hosted connection and a local stdio server that forwards calls to Cotlet.dev.

Key features

  1. 01Create and email estimates
  2. 02Turn approved estimates into jobs
  3. 03Schedule jobs with a crew
  4. 04Create and send invoices
  5. 05Review pending estimates and unpaid invoices

Use cases

  1. 01Email a customer an estimate for repair work
  2. 02Schedule a job from an approved estimate
  3. 03Check overdue invoices and amounts owed

MCP support

Exposes Contractor+ tools to MCP clients through Cotlet.dev's hosted endpoint. A local stdio server is also available and forwards tool calls to the hosted service.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://cotlet.dev/mcp/v1/contractor-plus/connect
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

All endpoints
Streamable HTTPhttps://cotlet.dev/mcp/v1/contractor-plus/connect
Streamable HTTPhttps://cotlet.dev/mcp/v1/contractor-plusAuth required

Tools

Details

From the project README

How to connect Contractor+ to Claude Code, ChatGPT and any AI agent

Yes, Claude, ChatGPT and other AI agents can work in your Contractor+ account. Contractor+'s own integration catalog lists no official ChatGPT app or Claude connector. Cotlet.dev connects your own signed-in Contractor+ account to any AI agent, so you can ask in plain words and the AI creates estimates, schedules jobs and sends invoices for you.

What you can ask

Create an estimate for Mark Davis: replace 120 sq ft of bathroom tile at $14 per sq ft labor plus $850 in materials, and email it to him.

Turn the approved estimate for the Rivera kitchen remodel into a job and schedule it for Monday at 8 am with Luis's crew.

Invoice Sarah Chen $2,400 for the deck repair we finished yesterday, due in 15 days.

Which estimates I sent in the last 30 days are still not approved? List them with the client and amount.

Show me all unpaid invoices older than 14 days and the total still owed.

Connect in 2 minutes

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

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

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

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 Contractor+ 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.

{"mcpServers":{"contractor-plus":{"command":"uvx","args":["contractor-plus-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

Or with Docker:

docker build -t contractor-plus-mcp .
docker run -i --rm -e COTLET_API_KEY contractor-plus-mcp

Tools: contractor_plus_guide, contractor_plus_status, contractor_plus_open, contractor_plus_read, contractor_plus_click, contractor_plus_type, contractor_plus_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+, nothing else to install. From PyPI:

pip install contractor-plus-mcp        # or run it once: uvx contractor-plus-mcp connect
contractor-plus-mcp connect

Or straight from this repo:

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

Questions from Contractor+ users

Does Contractor+ have an API?

Contractor+ has a public API with an account key, but it comes only with the Pro Team plan, together with Zapier. Cotlet.dev works in your own signed-in Contractor+ account on any plan, so your AI agent can create estimates, jobs and invoices.

How do I connect Contractor+ to ChatGPT?

Add Cotlet.dev as an app in ChatGPT (Settings → Apps, connector URL https://cotlet.dev/mcp/v1), sign in to Contractor+ once in your Cotlet.dev Cloud Browser, and ask ChatGPT in plain words. No code and no Contractor+ API key.

Is there a way to use Claude with Contractor+?

Yes. In Claude Code run the one-line claude mcp add command above; in the Claude app add https://cotlet.dev/mcp/v1 as a custom connector. Claude then works in your own Contractor+ account.

Is there a Contractor+ MCP server?

Contractor+ has no official MCP server and no official app in ChatGPT or Claude (checked November 2026). Cotlet.dev is a hosted Contractor+ MCP server that works in your own account, with Claude, ChatGPT, Cursor, Codex, n8n, Make and Zapier.

Find it on

Also works with


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

Start free: https://cotlet.dev/signup?app=contractor-plus&utm_source=github&utm_medium=readme&utm_campaign=contractor-plus

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.