# Sellsy MCP by usefulapi

> Sellsy MCP by usefulapi is an MCP server. Search and read Sellsy companies, contacts, opportunities, invoices and tasks; create records. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Search and read Sellsy companies, contacts, opportunities, invoices and tasks; create records.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `sellsy_get_estimate_pdf`: Download the current PDF of an authorized estimate and return its actual bytes as an embedded application/pdf resource. Resolves the current pdf_link through estimates.read. Supports HTTPS links and up to three redirects on Sellsy-owned sellsy.com hosts only; sends no API credentials to the download host. Rejects login pages, non-PDF replies, unsupported hosts and PDFs above 2 MiB. This reads the 
- `sellsy_create_draft_estimate`: WRITE: preview a Sellsy estimate with free-text or catalog rows; only confirm:true plus the approved preview_hash creates it. Supply a stable operation_id and reuse it for retries. Single rows require a decimal unit_amount; catalog rows can omit it to inherit the catalog price shown in preview. Zero is explicit; blank/null prices are rejected. related links a company/individual and its opportuniti
- `sellsy_update_draft_estimate`: WRITE: update only a draft estimate, after preview and user approval. A fresh full snapshot and computed prices/totals must still match preview_hash. Supply all current row ids exactly once in existing order (unchanged rows as {id}), followed by optional new free-text/catalog/comment rows. Omit rows to leave them untouched. This tool never deletes or reorders rows, sends, changes status, signs or 
- `sellsy_estimate_operation_status`: Read the durable state and verified estimate id for this hosted personal API client's operation_id. Keep the original client to reconcile an uncertain attempt; changing credentials does not carry operation history to another client. An uncertain attempt is not automatically replayed.
- `sellsy_get_estimate_pdf_link`: Read the documented pdf_link from an authorized Sellsy estimate. Returns the vendor URL for the user/client to open; does not download, parse or claim to read PDF contents. The link can change after edits. Needs estimates.read.
- `sellsy_list_estimate_files`: List the files/directories attached to an estimate through its documented open-beta endpoint. Requires estimates.read and files.read. Does not upload, associate or read file contents.
- `sellsy_search`: Free-text search over companies, individuals, contacts, opportunities, items, documents and staff in one call (GET /search). Use it to find a record by name, email or number when you do not know its type. Needs the search.read scope.
- `sellsy_list_companies`: List companies (customers, prospects, suppliers) with paging. Needs companies.read.
- `sellsy_search_companies`: Search companies by name, email, type (prospect/client/supplier), reference, VAT, SIRET, country, postal code, creation or update date. Needs companies.read.
- `sellsy_get_company`: Get one company by id. Needs companies.read.
- `sellsy_list_company_contacts`: List the contacts linked to one company (GET /companies/{id}/contacts). Needs companies.read and contacts.read.
- `sellsy_list_individuals`: List individuals (private customers, prospects, suppliers) with paging. Needs individuals.read.
- `sellsy_search_individuals`: Search individuals by name, email, type, reference, country, postal code, creation or update date. Needs individuals.read.
- `sellsy_get_individual`: Get one individual by id. Needs individuals.read.
- `sellsy_list_contacts`: List contacts (people at companies) with paging. Needs contacts.read.
- `sellsy_search_contacts`: Search contacts by last name, email, phone, linked company or individual, creation date. Needs contacts.read.
- `sellsy_get_contact`: Get one contact by id. Needs contacts.read.
- `sellsy_list_opportunities`: List sales opportunities with paging. Needs opportunities.read.
- `sellsy_search_opportunities`: Search opportunities by name, number, pipeline, step, status (open/won/lost/cancelled/closed/late), amount, owner or due date. Needs opportunities.read.
- `sellsy_get_opportunity`: Get one opportunity by id. Needs opportunities.read.
- `sellsy_list_opportunity_pipelines`: List the sales pipelines (needed to create an opportunity: pipeline id and step id). Needs opportunities.read.
- `sellsy_list_pipeline_steps`: List the steps of one opportunity pipeline. Needs opportunities.read.
- `sellsy_list_estimates`: List estimates (quotes) with paging. Needs estimates.read.
- `sellsy_search_estimates`: Search estimates by status, number, date, currency, owner, contact or related company/individual/opportunity. Needs estimates.read.
- `sellsy_get_estimate`: Get one estimate by id, with its rows and amounts. Needs estimates.read.
- `sellsy_list_invoices`: List invoices with paging. Needs invoices.read.
- `sellsy_search_invoices`: Search invoices by status (draft/due/payinprogress/paid/late/cancelled), number, date, currency, owner, or related company/individual/opportunity. Use it for unpaid or late invoices. Needs invoices.read.
- `sellsy_get_invoice`: Get one invoice by id, with its rows, amounts and status. Needs invoices.read.
- `sellsy_list_invoice_payments`: List the payments linked to one invoice. Needs invoices.read and payments.read.
- `sellsy_list_orders`: List orders with paging. Needs orders.read.
- `sellsy_search_orders`: Search orders by status or delivery status, or related company/individual/opportunity. Needs orders.read.
- `sellsy_get_order`: Get one order by id. Needs orders.read.
- `sellsy_list_credit_notes`: List credit notes with paging. Needs credit-notes.read.
- `sellsy_get_credit_note`: Get one credit note by id. Needs credit-notes.read.
- `sellsy_list_items`: List catalog items (products, services, shipping, packaging) with paging. Needs items.read.
- `sellsy_search_items`: Search catalog items by name, reference or type. Needs items.read.
- `sellsy_get_item`: Get one catalog item by id. Needs items.read.
- `sellsy_search_payments`: Search payments by status (pending/confirmed/rejected/failed/refund) or related company/individual. Needs payments.read.
- `sellsy_list_tasks`: List tasks with paging. Needs tasks.read.
- `sellsy_search_tasks`: Search tasks by status (todo/done), owner, assignee, label, due date or related record. Needs tasks.read.
- `sellsy_get_task`: Get one task by id. Needs tasks.read.
- `sellsy_list_task_labels`: List the task labels (a label id is required to create a task). Needs tasks.read.
- `sellsy_search_comments`: Search comments and notes by author, date, parent comment or the company/individual/contact they are attached to. Needs comments.read.
- `sellsy_list_staffs`: List the staff members of the account (the list may hold only yourself, depending on the Sellsy plan). Needs staffs.read.
- `sellsy_create_company`: WRITE: create a company record in Sellsy (a prospect, client or supplier). Needs companies.write. Nothing is sent to the company.
- `sellsy_create_individual`: WRITE: create an individual (a private person as prospect, client or supplier) in Sellsy. Needs individuals.write.
- `sellsy_create_contact`: WRITE: create a contact (a person) in Sellsy. It is not linked to a company by this call. Needs contacts.write.
- `sellsy_create_opportunity`: WRITE: create a sales opportunity linked to a company, individual or contact. Needs a pipeline id and one of its step ids (see sellsy_list_opportunity_pipelines and sellsy_list_pipeline_steps). Needs opportunities.write.
- `sellsy_move_opportunity`: WRITE: move an existing opportunity to another step of its pipeline, or to a step of another pipeline (then pass that pipeline too). Only the step (and the pipeline) change; the name, amount, status and links stay. Get the ids from sellsy_get_opportunity, sellsy_list_opportunity_pipelines and sellsy_list_pipeline_steps. Needs opportunities.write.
- `sellsy_create_comment`: WRITE: add a comment (note) to a company, individual, contact, opportunity or document. Visible to the Sellsy staff, not sent to the customer. Needs comments.write.
- `sellsy_create_task`: WRITE: create a task, optionally attached to a record and assigned to staff. Needs a label id (see sellsy_list_task_labels) and a due date-time. Needs tasks.write.

## FAQ

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

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

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