Skip to content
MCP server

Sellsy MCP by usefulapi

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

Install
Runs
Remotely
Version
1.20.0
Listing updated
4 days ago

About Sellsy MCP by usefulapi

Sellsy MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://sellsy.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sellsy": {
      "url": "https://sellsy.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (51)

Read directly from the server.

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.

Sellsy MCP by usefulapi 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