# OfficeGest MCP by usefulapi

> OfficeGest MCP by usefulapi is an MCP server. Read customers, stock, sales documents and debt reports; create customers in OfficeGest. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/officegest/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/officegest
- **MCP Registry name:** io.usefulapi/officegest
- **Listing updated:** 2026-11-13

## About

Read customers, stock, sales documents and debt reports; create customers in OfficeGest.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http officegest https://officegest.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://officegest.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "officegest": {
      "url": "https://officegest.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "officegest": {
      "type": "http",
      "url": "https://officegest.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "officegest": {
      "serverUrl": "https://officegest.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "officegest": {
      "type": "http",
      "url": "https://officegest.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `officegest_list_customers`: List customers with tax id, contacts and status. Filter by name, tax id, email, active flag or type. Pass meta.next as cursor for the next page. Uses GET /entities/customers.
- `officegest_get_customer`: Get one customer by id: name, tax id, address, contacts, type and status. Uses GET /entities/customers/{customer}.
- `officegest_get_customer_balance`: Get the current balance of one customer: what the customer owes the company. Uses GET /entities/customers/{customer}/balance.
- `officegest_create_customer`: Create a customer record. Creates data in OfficeGest; it does not merge with an existing customer, so search first. Uses POST /entities/customers.
- `officegest_list_suppliers`: List suppliers with tax id, contacts and status. Filter by search text, name, tax id, e-mail or active flag. Uses GET /entities/suppliers.
- `officegest_get_supplier`: Get one supplier by id: name, tax id, address and contacts. Uses GET /entities/suppliers/{supplier}.
- `officegest_search_articles`: Search articles (products and services) by text, barcode, family or warehouse. Uses GET /stocks/articles/search.
- `officegest_get_article`: Get one article by id: description, prices, measurement unit, VAT and stock totals. Uses GET /stocks/articles/{article}.
- `officegest_list_stock_quantities`: List stock quantities per article and warehouse. Zero-stock rows are left out unless include_zero_stock is true. Uses GET /stocks/quantities.
- `officegest_list_sale_document_types`: List the sale document types of the company, with their codes. Use a code with officegest_list_sale_documents. Uses GET /sales/documents.
- `officegest_list_sale_documents`: List sale documents of one type (for example invoices), with number, customer, date, due date and state. Pass meta.next as cursor for the next page. Uses GET /sales/documents/{type}.
- `officegest_get_sale_document`: Get one sale document by type and id: header, customer, lines and totals. Uses GET /sales/documents/{type}/{id}.
- `officegest_get_sales_summary`: Get the sales summary: the current month, the previous month, the monthly average and the current year. Uses GET /sales/reports/sales-summary.
- `officegest_list_customer_invoices_due`: List customer invoices that are not yet fully paid, with the amount pending. Uses GET /sales/reports/customer-invoices-due.
- `officegest_list_top_debtors`: List the customers who owe the most, with their balance. Uses GET /sales/reports/top-debtors.
- `officegest_list_supplier_invoices_due`: List supplier invoices that are not yet fully settled, with the amount pending. Uses GET /purchases/reports/supplier-invoices-due.

## FAQ

### How do I add OfficeGest MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http officegest https://officegest.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/officegest-mcp-by-usefulapi
