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_.
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.
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.
Tool families
| Family | Tools |
|---|---|
| Other tools | 16 |
| Create and change (€29) | 6 |
| Delete (€29) | 3 |
Other tools
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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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 · 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)
Served with the €29 plan.
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 · 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 · 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 · 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 · 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 · 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)
Served with the €29 plan. A deletion targets one object at a time.
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 · 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 · 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). |