# Sellsy

Source: https://pilot.braike.com/en/docs/regies/sellsy

The 25 tools Pilot MCP serves for Sellsy: 16 read-only, and 9 that write with the €29 plan, taken from the server.

Pilot MCP serves **16 read-only tools** for Sellsy, on every plan. With the €29 plan, it also serves **6** that create or change and **3** that delete. Their names start with `sellsy_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 16 |
| [Create and change (€29)](#modification) | 6 |
| [Delete (€29)](#suppression) | 3 |

## Other tools [#autres]

### `sellsy_get_account` [#sellsy_get_account]

**Sellsy: Get Account** · read-only · idempotent

Identity of the connected Sellsy account (teams via /teams). Call it first to check that the token is valid. Read-only.

No parameters.

### `sellsy_get_company` [#sellsy_get_company]

**Sellsy: Get Company** · read-only · idempotent

Details of a Sellsy company by its identifier. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Sellsy identifier of the company. |
| `embed` | `string[]` | no | Related objects to include. |

### `sellsy_get_invoice` [#sellsy_get_invoice]

**Sellsy: Get Invoice** · read-only · idempotent

Details of an invoice (lines, amounts excluding and including tax, status, due date). Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Sellsy identifier of the invoice. |
| `embed` | `string[]` | no | Related objects to include. |

### `sellsy_get_opportunity` [#sellsy_get_opportunity]

**Sellsy: Get Opportunity** · read-only · idempotent

Details of one Sellsy opportunity by its identifier. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Sellsy identifier of the opportunity. |

### `sellsy_get_task` [#sellsy_get_task]

**Sellsy: Get Task** · read-only · idempotent

Details of one Sellsy task by its identifier. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Sellsy identifier of the task. |

### `sellsy_list_companies` [#sellsy_list_companies]

**Sellsy: List Companies** · read-only · idempotent

Lists the companies (customers, prospects, suppliers) of the Sellsy account. To filter by type, name, creation date or country, use search\_companies. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |
| `order` | `string` | no | Sort field. Values: `"name"`, `"id"`, `"created_at"`, `"updated_at"`. |
| `direction` | `string` | no | Sort direction. Values: `"asc"`, `"desc"`. |
| `embed` | `string[]` | no | Related objects to include: 'main\_contact', 'invoicing\_address', 'opportunities', 'invoices', 'smart\_tags', 'owner'... (each one requires its own OAuth scope). |

### `sellsy_list_individuals` [#sellsy_list_individuals]

**Sellsy: List Individuals** · read-only · idempotent

Lists individuals (private-person customers, distinct from the contacts attached to a company). Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |
| `order` | `string` | no | Sort field. Values: `"id"`, `"created_at"`, `"updated_at"`. |
| `direction` | `string` | no | Sort direction. Values: `"asc"`, `"desc"`. |

### `sellsy_list_items` [#sellsy_list_items]

**Sellsy: List Items** · read-only · idempotent

Lists the catalog (billable products and services). Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |
| `direction` | `string` | no | Sort direction. Values: `"asc"`, `"desc"`. |

### `sellsy_list_payments` [#sellsy_list_payments]

**Sellsy: List Payments** · read-only · idempotent

Lists the payments recorded in the Sellsy account, paginated. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |
| `direction` | `string` | no | Sort direction. Values: `"asc"`, `"desc"`. |

### `sellsy_list_pipelines` [#sellsy_list_pipelines]

**Sellsy: List Pipelines** · read-only · idempotent

Lists the sales pipelines and their steps. Call it BEFORE creating an opportunity: \`pipeline\` and \`step\` are required there. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |

### `sellsy_list_tasks` [#sellsy_list_tasks]

**Sellsy: List Tasks** · read-only · idempotent

Lists the CRM tasks of the Sellsy account, paginated. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |
| `direction` | `string` | no | Sort direction. Values: `"asc"`, `"desc"`. |

### `sellsy_search_all` [#sellsy_search_all]

**Sellsy: Search All** · read-only · idempotent

Cross-object full-text search (companies, contacts, documents...). Handy to find a customer's identifier from its name. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | `string` | yes | Search term. |
| `type` | `string[]` | no | Object types to restrict to, e.g. \['company','contact','invoice'\]. |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `archived` | `boolean` | no | Include archived objects. |

### `sellsy_search_companies` [#sellsy_search_companies]

**Sellsy: Search Companies** · read-only · idempotent

Searches companies with filters (customer/prospect/supplier type, name, email, SIRET, postal code, country, creation date). It is the ONLY way to filter by date. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | no | Filter on the name (partial match). |
| `email` | `string` | no | Filter on the email. |
| `type` | `string[]` | no | Third-party types to keep. Values: `"prospect"`, `"client"`, `"supplier"`. |
| `created` | `object` | no | Creation date range. |
| `country_code` | `string` | no | Two-letter ISO country code, e.g. 'FR'. |
| `postal_code` | `string` | no | Postal code. |
| `is_archived` | `boolean` | no | Include or exclude archived records. |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |

### `sellsy_search_estimates` [#sellsy_search_estimates]

**Sellsy: Search Estimates** · read-only · idempotent

Searches estimates (quotes) with filters (date range, status). Used to measure the quoted volume and the conversion rate. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `date` | `object` | no | Document date range. |
| `created` | `any` | no | Creation date range. |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |

### `sellsy_search_invoices` [#sellsy_search_invoices]

**Sellsy: Search Invoices** · read-only · idempotent

Searches invoices with filters (date range, status, customer, currency). It is the revenue tool: filter status=\['paid'\] over a \`date\` range for collected revenue. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `date` | `object` | no | Document date range (invoicing). |
| `status` | `string[]` | no | Statuses to keep. 'paid' = collected, 'late' = overdue. Values: `"draft"`, `"due"`, `"payinprogress"`, `"paid"`, `"late"`, `"cancelled"`. |
| `number` | `string` | no | Invoice number. |
| `currency` | `string` | no | ISO currency, e.g. 'EUR'. |
| `created` | `any` | no | Creation date range. |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |

### `sellsy_search_opportunities` [#sellsy_search_opportunities]

**Sellsy: Search Opportunities** · read-only · idempotent

Searches opportunities with filters (pipeline, step, status, amount, creation or due date, owners). Used to measure the sales pipeline. Read-only.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | no | Filter on the name. |
| `statuses` | `string[]` | no | Statuses to keep, e.g. \['won'\] for signed revenue. Values: `"open"`, `"won"`, `"lost"`, `"cancelled"`, `"closed"`, `"late"`. |
| `pipeline` | `integer[]` | no | Pipeline identifiers. |
| `step` | `integer[]` | no | Step identifiers. |
| `created` | `object` | no | Creation date range. |
| `due_date` | `any` | no | Due date range. |
| `limit` | `integer` | no | Number of items (1-100, default 25). |
| `offset` | `integer` or `string` | no | Page cursor: send back AS IS the \`pagination.offset\` of the previous call (often an opaque base64 string). Never increment it. |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `sellsy_create_company` [#sellsy_create_company]

**Sellsy: Create Company** · create or change, €29 plan · creates an object on each call

Creates a company (customer, prospect or supplier) in Sellsy. WRITE: simulated by default, requires dry\_run=false + confirm=true.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | yes | Company legal name. Required. |
| `type` | `string` | yes | Kind of third party. Required. Values: `"prospect"`, `"client"`, `"supplier"`. |
| `email` | `string` | no | Main email. |
| `website` | `string` | no | Website. |
| `phone_number` | `string` | no | Landline phone number. |
| `mobile_number` | `string` | no | Mobile phone number. |
| `reference` | `string` | no | Internal reference. |
| `note` | `string` | no | Free-text note. |
| `owner_id` | `integer` | no | Identifier of the owning salesperson. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `sellsy_create_contact` [#sellsy_create_contact]

**Sellsy: Create Contact** · create or change, €29 plan · creates an object on each call

Creates a contact (person attached to a company) in Sellsy. WRITE: simulated by default, requires dry\_run=false + confirm=true.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `last_name` | `string` | yes | Last name. Required. |
| `first_name` | `string` | no | First name. |
| `email` | `string` | no | Email address. |
| `position` | `string` | no | Job title. |
| `phone_number` | `string` | no | Landline phone number. |
| `mobile_number` | `string` | no | Mobile phone number. |
| `note` | `string` | no | Free-text note. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `sellsy_create_individual` [#sellsy_create_individual]

**Sellsy: Create Individual** · create or change, €29 plan · creates an object on each call

Creates an individual (private-person customer) in Sellsy. WRITE: simulated by default, requires dry\_run=false + confirm=true.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `last_name` | `string` | yes | Last name. Required. |
| `type` | `string` | yes | Kind of third party. Required. Values: `"prospect"`, `"client"`, `"supplier"`. |
| `first_name` | `string` | no | First name. |
| `email` | `string` | no | Email address. |
| `phone_number` | `string` | no | Landline phone number. |
| `mobile_number` | `string` | no | Mobile phone number. |
| `note` | `string` | no | Free-text note. |
| `owner_id` | `integer` | no | Identifier of the owning salesperson. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `sellsy_create_opportunity` [#sellsy_create_opportunity]

**Sellsy: Create Opportunity** · create or change, €29 plan · creates an object on each call

Creates a sales opportunity in Sellsy. \`pipeline\` and \`step\` are required: get them through list\_pipelines BEFORE calling this tool. WRITE: simulated by default, requires dry\_run=false + confirm=true.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | yes | Name of the opportunity. Required. |
| `pipeline` | `integer` | yes | Pipeline identifier (list\_pipelines). Required. |
| `step` | `integer` | yes | Step identifier (list\_pipelines). Required. |
| `related` | `object[]` | yes | Attached third party: exactly one company OR one individual. Required. |
| `amount` | `number` | no | Estimated amount. |
| `probability` | `number` | no | Probability of success (0-100). |
| `status` | `string` | no | Status, default 'open'. Values: `"open"`, `"won"`, `"lost"`, `"cancelled"`, `"closed"`, `"late"`. |
| `due_date` | `string` | no | Due date, format YYYY-MM-DD. |
| `note` | `string` | no | Free-text note. |
| `owner_id` | `integer` | no | Identifier of the owning salesperson. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `sellsy_create_task` [#sellsy_create_task]

**Sellsy: Create Task** · create or change, €29 plan · creates an object on each call

Creates a CRM task attached to a third party or an opportunity. WRITE: simulated by default, requires dry\_run=false + confirm=true.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `due_date` | `string` | yes | Due date, format YYYY-MM-DD. Required. |
| `label_id` | `integer` | yes | Identifier of the task label. Required. |
| `related` | `object[]` | yes | Attached object (only one). Required. |
| `title` | `string` | no | Title of the task. |
| `description` | `string` | no | Description of the task. |
| `assigned_staff_ids` | `integer[]` | no | Identifiers of the assigned staff members. |
| `owner_id` | `integer` | no | Identifier of the owner. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `sellsy_update_opportunity` [#sellsy_update_opportunity]

**Sellsy: Update Opportunity** · create or change, €29 plan · creates an object on each call

Updates an opportunity (step, status, amount, due date): the tool to move a deal forward in the pipeline. WRITE: simulated by default, requires dry\_run=false + confirm=true.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Identifier of the opportunity. Required. |
| `step` | `integer` | no | New step (list\_pipelines). |
| `status` | `string` | no | New status. Values: `"open"`, `"won"`, `"lost"`, `"cancelled"`, `"closed"`, `"late"`. |
| `amount` | `number` | no | New amount. |
| `probability` | `number` | no | New probability (0-100). |
| `due_date` | `string` | no | New due date, format YYYY-MM-DD. |
| `note` | `string` | no | Free-text note. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

## Delete (€29) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `sellsy_delete_company` [#sellsy_delete_company]

**Sellsy: Delete Company** · delete, €29 plan, one object at a time · creates an object on each call

Deletes one Sellsy company by its identifier. WRITE: simulated by default, requires dry\_run=false + confirm=true. The object is read before (an unknown id is an error) and after (still readable after the call is an error). The Sellsy API documents no trash and no restore for it: the deletion is permanent.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Sellsy identifier of the company to delete. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `sellsy_delete_opportunity` [#sellsy_delete_opportunity]

**Sellsy: Delete Opportunity** · delete, €29 plan, one object at a time · creates an object on each call

Deletes one Sellsy opportunity by its identifier. WRITE: simulated by default, requires dry\_run=false + confirm=true. The object is read before (an unknown id is an error) and after (still readable after the call is an error). The Sellsy API documents no trash and no restore for it: the deletion is permanent.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Sellsy identifier of the opportunity to delete. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |

### `sellsy_delete_task` [#sellsy_delete_task]

**Sellsy: Delete Task** · delete, €29 plan, one object at a time · creates an object on each call

Deletes one Sellsy task by its identifier. WRITE: simulated by default, requires dry\_run=false + confirm=true. The object is read before (an unknown id is an error) and after (still readable after the call is an error). The Sellsy API documents no trash and no restore for it: the deletion is permanent.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `integer` | yes | Sellsy identifier of the task to delete. |
| `dry_run` | `boolean` | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
| `confirm` | `boolean` | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
