Skip to main content
Glama
README.md
# 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](https://cotlet.dev/signup?app=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:

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

### Claude Code

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

## Building-trade office workflows

Examples from the [live Extrabat reference](https://cotlet.dev/integrations/extrabat-api-mcp-server):

- 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:

```json
{"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.

```bash
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

- [Extrabat connection guide and operation reference](https://cotlet.dev/integrations/extrabat-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=extrabat)
- [Request access](https://cotlet.dev/signup?app=extrabat)
- [Cotlet.dev console](https://cotlet.dev/app)

Licensed under Elastic License 2.0. See LICENSE.

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