MCP server
Sellsy MCP by usefulapi
Search and read Sellsy companies, contacts, opportunities, invoices and tasks; create…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://sellsy.usefulapi.io/mcpInstall 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