# mokocrm-mcp

![Language](https://img.shields.io/badge/language-TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white) ![License](https://img.shields.io/badge/license-GPL--3.0--or--later-green?style=flat-square) ![Platform](https://img.shields.io/badge/platform-MCP%20%7C%20Dolibarr-339933?style=flat-square)

MCP (Model Context Protocol) server purpose-built for the **MokoCRM ecosystem**. Bridges Dolibarr CRM operations — contacts, proposals, invoices, contracts, interventions, extrafields, email templates, and workflow automation — for AI assistants like Claude.

## Relationship to dolibarr-api-mcp

| | `dolibarr-api-mcp` | `mokocrm-mcp` |
|---|---|---|
| **Scope** | Generic Dolibarr REST API | MokoCRM-specific workflows |
| **Tools** | Raw CRUD on all Dolibarr objects | CRM-focused: pipeline, proposals, invoicing |
| **Extrafields** | Generic extrafield access | MokoCRM extrafield schema awareness |
| **Email** | None | MokoCRM branded email template management |
| **Dictionaries** | Generic dictionary access | Commission rates, meeting times, lead stages |

## Features

- **CRM Pipeline** — manage leads, opportunities, and deal stages with MokoCRM's custom pipeline
- **Proposal Workflow** — create, validate, sign proposals with branded email notifications
- **Invoice Lifecycle** — generate invoices from proposals, track payments, send overdue reminders
- **Contract Management** — service contracts with intervention tracking
- **Extrafield Intelligence** — knows MokoCRM's 37 custom extrafields across 12 Dolibarr objects
- **Email Templates** — trigger MokoCRM's branded email templates with Dolibarr substitution variables

## Setup

```bash
npm install
npm run build
```

## Configuration

Copy `config.example.json` to `config.json`:

```json
{
  "connections": {
    "default": {
      "url": "https://your-dolibarr.example.com",
      "apiKey": "your-api-key"
    }
  }
}
```

## Development

```bash
npm run dev    # Watch mode
npm run build  # Production build
npm run lint   # Lint check
```

---

*Part of the [MokoCRM](https://git.mokoconsulting.tech/MokoConsulting/MokoCRM) ecosystem by [Moko Consulting](https://mokoconsulting.tech)*