Zettle MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.5.3Updated Nov 7, 2026

Read sales, products, stock, balance and payouts; create products in Zettle.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for a Zettle point-of-sale account: read sales, refunds, products, stock, balance and payouts, and create products.

What you can do
  • Read sales and refunds: list purchases in a date window and fetch one purchase with line items, VAT and payments
  • Browse the product library: products, variants, categories and discounts
  • Check stock: list store inventories and read balances per variant or for specific products
  • Create a new product in the Zettle library (the only write tool)
  • Check finances: account balance, account transactions and next payout details
  • Manage the subscription: usage status, upgrade and cancel
When to use it
Useful when a merchant wants to ask an assistant about their Zettle shop in plain language, for example yesterday's sales and refunds, which products are low on stock, or how much is in the account and when the next payout arrives. Also handy for adding products to the library without opening the Zettle back office.
Requirements
Remote hosted endpoint; no local install. Connect with the server URL only and sign in to Zettle through OAuth on first connect; only the Zettle account owner can approve access. No API key or Authorization header goes in the client config. A free tier allows 50 tool calls per month; paid plans raise the limit.
Before you install
Creating a product writes to the live Zettle library and is not idempotent, so a repeated call creates duplicates; confirm before write tools run. The server reads merchant financial data (balances, transactions, payouts) and sales records. Paid plans cost money (Pro and Pro+) and are billed through a payment link; cancellation runs to the end of the paid period with no refund for the current period. Usage is metered per tool call.

Installation

In SourceWeft

  1. Open Zettle MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fzettle/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "zettle-by-usefulapi": {
      "type": "http",
      "url": "https://zettle.usefulapi.io/mcp"
    }
  }
}

README

Zettle MCP by usefulapi

Use your Zettle account from Claude, Cursor, or any MCP client. Read sales, refunds, products, stock, balance and payouts, and create products. Hosted, no local install: connect with your own credentials.

Live endpoint: https://zettle.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://zettle.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http zettle https://zettle.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "zettle": {      "url": "https://zettle.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and you sign in with your Zettle account.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/zettle/

On first connect you sign in to Zettle and approve access. Only the Zettle account owner can approve it. You can disconnect it any time in Zettle. No keys go in config files.

Tools

ToolTypeWhat it does
zettle_get_accountreadGet account
zettle_list_purchasesreadList purchases
zettle_get_purchasereadGet purchase
zettle_list_productsreadList products
zettle_get_productreadGet product
zettle_list_categoriesreadList categories
zettle_get_libraryreadGet product library with discounts
zettle_create_productwriteCreate product
zettle_list_inventoriesreadList inventories (stock locations)
zettle_get_stockreadGet stock balances
zettle_get_stock_for_productsreadGet stock for products
zettle_get_account_balancereadGet account balance
zettle_list_account_transactionsreadList account transactions
zettle_get_payout_inforeadGet payout info
zettle_usage_statusmetaUsage status (free-tier meter)
zettle_request_featuremetaRequest a missing feature
zettle_upgrademetaUpgrade to Pro or Pro+
zettle_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with zettle_upgrade (it returns a Stripe Checkout link). Cancel any time with zettle_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running zettle_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/zettle/README.md at commit 4046075

Tools

14

zettle_get_account

Get account

The Zettle user and organization this API key belongs to (uuid, organizationUuid). GET oauth.zettle.com/users/self.

Takes no parameters.

zettle_list_purchases

List purchases

List POS purchases (sales and refunds) with amount, currency, timestamp, products, discounts, payments, refund info and the cashier. Needs READ:PURCHASE. Amounts are in the smallest currency unit. Default window is the last 3 years. Page with next_page_hash (pass it back as last_purchase_hash with the same other arguments). GET /purchases/v2.

Parameterslimitend_datedescendingstart_datelast_purchase_hash

zettle_get_purchase

Get purchase

One purchase (sale or refund) in full by its purchase UUID (the purchaseUUID1 field of zettle_list_purchases; the older short purchaseUUID is deprecated and not accepted): line items, VAT, payments, refund links. Needs READ:PURCHASE. GET /purchase/v2/{purchaseUuid}.

Parameterspurchase_uuidrequired

zettle_list_products

List products

List the products in the POS product library with variants (SKU, barcode, price, cost price, VAT), category, online status and ETag. Zettle returns the whole library at once; this tool slices it with limit/offset and filters by name. Needs READ:PRODUCT. Prices are in the smallest currency unit. GET /organizations/self/products/v2.

Parameterslimitoffsetname_contains

zettle_get_product

Get product

One product by UUID with all variants, prices, VAT, category, images and online-store data. Needs READ:PRODUCT. GET /organizations/self/products/{productUuid}.

Parametersproduct_uuidrequired

zettle_list_categories

List categories

List the product categories (uuid, name). Needs READ:PRODUCT. GET /organizations/self/categories/v2.

Takes no parameters.

zettle_get_library

Get product library with discounts

The product library together with its discounts (name, amount or percentage), paginated. Returns products, discounts and next_offset (pass it back as offset). Needs READ:PRODUCT. GET /organizations/self/library.

Parameterslimitoffset

zettle_create_product

Create product

WRITE: add a new product to the Zettle product library (it appears in the POS and, if enabled, the online store). Not idempotent: calling twice creates two products. Needs READ:PRODUCT and WRITE:PRODUCT. vat_percentage must be one of the VAT rates enabled in the merchant's Zettle settings. Prices are in the smallest currency unit. POST /organizations/self/products.

Parametersnamerequiredvariantsrequireddescriptionvat_percentagerequired

zettle_list_inventories

List inventories (stock locations)

List the stock locations (inventories): inventoryUuid, name, type (STORE, SOLD, SUPPLIER, BIN) and which is the default. Use the STORE inventoryUuid with zettle_get_stock. Needs READ:PRODUCT. GET /v3/inventories.

Takes no parameters.

zettle_get_stock

Get stock balances

Stock balances per product variant (balance, low-stock level and alert, last update). With inventory_uuid: that STORE inventory only; without: all stores. Only products with inventory tracking enabled appear. Needs READ:PRODUCT. Page with next_cursor. GET /v3/stock or /v3/stock/{inventoryUuid}.

Parameterslimitcursorinventory_uuid

zettle_get_stock_for_products

Get stock for products

Stock balances of a few specific products in one inventory (read-only lookup, nothing is changed). Needs READ:PRODUCT. Page with next_cursor (send the same product_uuids again). POST /v3/stock/{inventoryUuid}/products with the product UUIDs.

Parameterslimitcursorproduct_uuidsrequiredinventory_uuidrequired

zettle_get_account_balance

Get account balance

The merchant's Zettle account balance (totalBalance in the smallest currency unit, currencyId). LIQUID = money available for payout; PRELIMINARY = payments not yet settled. Optional point in time. Needs READ:FINANCE. GET /v2/accounts/{LIQUID|PRELIMINARY}/balance.

Parametersataccountrequired

zettle_list_account_transactions

List account transactions

Transactions (payments, fees, payouts, adjustments) in the LIQUID or PRELIMINARY account between start and end (end exclusive), with timestamp, amount (smallest currency unit, can be negative), type and originating transaction UUID. Needs READ:FINANCE. Page with next_offset. GET /v2/accounts/{account}/transactions.

Parametersendrequiredlimitstartrequiredtypesoffsetaccountrequired

zettle_get_payout_info

Get payout info

Payout information of the LIQUID account: totalBalance, currencyId, nextPayoutAmount, discountRemaining and payout periodicity. Needs READ:FINANCE. GET /v2/payout-info.

Parametersat

Version history

8
  1. v1.5.3LatestNov 7, 2026
  2. v1.4.3Nov 5, 2026
  3. v1.4.2Nov 5, 2026
  4. v1.4.1Nov 4, 2026
  5. v1.4.0Nov 3, 2026
  6. v1.3.1Nov 3, 2026
  7. v1.2.0Nov 1, 2026
  8. v1.0.0Oct 31, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026