Skip to main content
Glama

Extrabat MCP server through Cotlet.dev

Connect Extrabat to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Manage customers, quotes, site visits and after-sales in your own signed-in Extrabat account.

This is an unofficial integration, not affiliated with Extrabat. Cotlet.dev hosts the connection through your Cloud Browser. This repository provides an optional Python stdio MCP bridge.

Connect your account

  1. Request access to Extrabat.

  2. Open https://myextrabat.com in your Cotlet.dev Cloud Browser, sign in yourself and enable Extrabat for agents.

  3. Connect your agent. Refresh the connector if you enabled Extrabat after connecting.

ChatGPT

Open Settings > Apps & Connectors > Create. Enter https://cotlet.dev/mcp/v1/connect as the MCP server URL and choose OAuth.

Claude

Open Settings > Connectors > Add custom connector and enter https://cotlet.dev/mcp/v1/connect.

Codex

Create a Cotlet.dev API key in your console and set COTLET_API_KEY in your environment. Add:

[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

Claude Code

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

Related MCP server: SimplyBoost MCP server

Building-trade office workflows

Examples from the live Extrabat reference:

  • Turn a website lead into a customer file and book a site visit.

  • Find unsigned quotes and prepare signature requests.

  • Draft a quote from your site notes.

  • Move completed after-sales tickets to the status used for invoicing.

  • List service contracts ending in the next 60 days.

  • Find unpaid invoices past their due date.

The live reference lists 13 hosted capabilities: 8 read and 5 write, grouped under extrabat_read and extrabat_write.

  • search_customers

  • create_customer

  • list_quotes

  • get_quote

  • create_quote

  • send_quote_for_signature

  • list_invoices

  • list_agenda_events

  • create_agenda_event

  • list_worksites

  • list_service_tickets

  • update_service_ticket_status

  • list_service_contracts

send_quote_for_signature and create_agenda_event ask for confirmation by default; you can configure this per tool. Signature requests reach the customer immediately through the paid Oodrive Sign option and require both email and phone. Agenda events sync to technicians' phones. The other three writes create a customer file, draft a quote or change a ticket status without sending a message. Search before creating a customer to avoid duplicates, and review a draft quote before sending it.

The connected Extrabat user and plan determine which modules you can open. Worksites, after-sales and service contracts start at Standard. This connection does not record payments or change account settings.

Optional local stdio bridge

Python 3.10 or newer is required, with no runtime dependencies. Clone this repository and configure a client that supports stdio:

{"mcpServers":{"extrabat":{"command":"python3","args":["/absolute/path/to/extrabat-mcp/extrabat_agent.py"],"env":{"COTLET_API_KEY":"your-cotlet-key"}}}}

The local bridge lists seven browser helpers: extrabat_guide, extrabat_status, extrabat_open, extrabat_read, extrabat_click, extrabat_type and extrabat_close. They forward to Cotlet.dev's shared browser tools and are distinct from the 13 hosted workflow capabilities. Call the guide first and close the browser when finished. Discovery works without a key; executing a tool requires your Cotlet.dev key and connected account.

python3 extrabat_agent.py connect
python3 extrabat_agent.py guide
python3 extrabat_agent.py status
python3 extrabat_agent.py serve

You can also build the included Dockerfile and pass COTLET_API_KEY as an environment variable.

Reference and access

Licensed under Elastic License 2.0. See LICENSE.

Available Tools

7 tools
extrabat_clickB

Click a numbered element on the current Extrabat page.

Inputs: element (required).

extrabat_closeA

Close the Extrabat browser session when the work is done, so credits stop running.

Inputs: no named parameters.

extrabat_guideA

How to work in Extrabat (customers, quotes, site visits and after-sales): its screens and the sign-in link. Call this first.

Inputs: task.

extrabat_openB

Open a Extrabat page in your signed-in Cloud Browser (default https://myextrabat.com) to work with customers, quotes, site visits and after-sales.

Inputs: url.

extrabat_readA

Read the current Extrabat page: its text and numbered buttons, links and fields.

Inputs: element.

extrabat_statusA

Check that your Cotlet.dev account and Extrabat are ready: account, credits and Extrabat connection.

Inputs: no named parameters.

extrabat_typeC

Type text into a numbered field on the current Extrabat page.

Inputs: text (required), element (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool maps to a distinct phase or primitive of a browser-automation workflow: status (account/credit check), guide (instructions), open (navigation), read (page inspection), click, type, and close. There is no meaningful overlap between read/click/type/close since they operate on different page interactions, and status vs guide is clearly separated by 'check readiness' vs 'how to work'.

    Naming Consistency5/5

    All seven tools use the same snake_case 'extrabat_<verb>' convention with a shared namespace prefix. No camelCase mixing or vague standalone verbs; the pattern is immediately predictable.

    Tool Count5/5

    Seven tools is exactly the right scope for a minimal browser-automation agent: one setup check, one guide, and the five core primitives needed to open, read, interact with, and close a session. Every tool earns its place with no filler.

    Completeness4/5

    The surface covers the full session lifecycle (status → guide → open → read → click/type → close), which matches the stated purpose. Minor gaps remain for richer page interaction—no dedicated select/option handling, scrolling, or explicit navigation/back beyond 'open'—but agents can work around these via click and re-open.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to securely access Twake Space team spaces, members, feeds, unread counts, votes, sign-offs, and meetings, and to perform actions as the user only after explicit prior approval.
      248 npm
      AGPL 3.0
    • 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