Connector guide7-minute read30 MCP tools7 languages

Bling MCP Server: Products, Stock and Sales Orders

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

HCBy HelpCode teamUpdated 7 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Bling

Bling

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

tools

30

Region

BR

Category

ERP

Authentication

OAuth 2.0

Required env vars

BLING_CLIENT_IDBLING_CLIENT_SECRET
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Guided setup

Connect Bling to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Bling in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Bling

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Bling · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Bling, paste the Client ID and Client Secret of your Bling app, click Authorize with Provider and allow access in Bling, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Bling

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Setup

Setting up takes about 10 minutes.

  1. In Bling open Central de Extensoes, Area do Integrador and click Criar aplicativo. Choose visibility Privado (it then works only with your own Bling account, without Bling's review).
  2. Fill in the name and contact data. As Link de redirecionamento enter https://cloud.anythingmcp.com/api/mcp-oauth/callback on AnythingMCP Cloud, or <your AnythingMCP URL>/api/mcp-oauth/callback when you host AnythingMCP yourself.
  3. Select the scopes this connector needs: products, stock, warehouses, sales orders, contacts, NF-e, accounts receivable and payable, payment methods, statuses and company data. Save. Changing scopes later signs every user out.
  4. On the tab Informacoes do app copy the Client ID and Client Secret into BLING_CLIENT_ID and BLING_CLIENT_SECRET, save the connector and click Authorize with Provider, then sign in to Bling and allow access.

Access tokens last 6 hours and are renewed with the refresh token, which lasts 30 days: a connector unused for longer than that needs Authorize with Provider again. Bling blocks an address for an hour after 20 token requests in a minute, so do not retry the sign-in in a loop.

Where to start: bling_get_company checks the connection. Then bling_list_orders (filter by date or status) and bling_get_order, or bling_list_products and bling_get_product.

Products and stock: bling_list_products, bling_get_product, bling_create_product, bling_update_product, bling_list_product_categories, bling_get_stock_balances, bling_get_warehouse_stock_balances, bling_create_stock_movement, bling_list_warehouses. bling_delete_product is installed switched off. saldoVirtual is the physical stock minus what open orders reserve.

Sales orders: bling_list_orders, bling_get_order, bling_create_order, bling_update_order_status. Status ids differ per account: read them with bling_list_status_modules (module Vendas) and bling_list_statuses. bling_delete_order is installed switched off. No tool posts receivables or settles payments.

Contacts: bling_list_contacts, bling_get_contact, bling_create_contact, bling_update_contact (replaces the whole contact: read it first).

NF-e: bling_list_invoices, bling_get_invoice (with DANFE and XML links), bling_generate_invoice_from_order (creates a pending draft only). bling_send_invoice, which transmits the NF-e to SEFAZ, is installed switched off: an authorized NF-e is a tax document. Turn it on only deliberately.

Finance (read-only): bling_list_receivables, bling_get_receivable, bling_list_payables, bling_list_payment_methods. The connector never moves money: no settlement (baixa), boleto or Pix action is included.

Field notes: ids are numbers. Amounts are in BRL with a decimal point. Dates are YYYY-MM-DD; a date range may span at most one year. CPF and CNPJ go as digits. Answers are wrapped in data; errors carry error.type, error.message, error.description and error.fields naming the invalid field.

Paging and limits: lists take pagina from 1 and limite up to 100; an empty data list is the end. Bling allows 3 requests per second and 120,000 per day per account (429 above); 300 errors or 600 requests within 10 seconds block the address for 10 minutes, so do not loop over failing calls.

Prerequisites: BLING_CLIENT_ID, BLING_CLIENT_SECRET

Install the connector locally

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Open http://localhost:3000/connectors/store, pick Bling and paste in the env vars listed under Prerequisites.

Available tools

ToolWhat it does
bling_get_companyGet the basic data of the Bling account the connector is signed in to: id, nome (company name), cnpj, email and dataContrato. A cheap call…
bling_list_productsList products: id, idProdutoPai, nome, codigo (SKU), preco, precoCusto, estoque (virtual balance), tipo, situacao, formato, descricaoCurta…
bling_get_productGet one product with all details: nome, codigo, preco, tipo, situacao, formato, unidade, gtin, marca, pesos, dimensoes, categoria, estoque…
bling_create_productCreate a product or service. nome, tipo, situacao and formato are required. Returns data.id of the new product (and of its variations). Tax…
bling_update_productChange a product (PATCH: only the fields sent change): name, SKU, price, status, unit, GTIN, brand, short description, weights or category.…
bling_delete_productDelete a product permanently. Products used in orders or invoices may be refused; prefer setting situacao I. Installed switched off
bling_list_product_categoriesList product categories: id, descricao and categoriaPai (parent). Up to 100 per page
bling_get_stock_balancesGet stock balances of products across all warehouses: per product saldoFisicoTotal (physical), saldoVirtualTotal (physical minus reserved…
bling_get_warehouse_stock_balancesGet stock balances of products in one warehouse (deposito): saldoFisico and saldoVirtual per product
bling_create_stock_movementRecord a stock movement for a product in a warehouse: E entrada (in), S saida (out) or B balanco (set the balance to the quantity). Returns…
bling_list_warehousesList warehouses (depositos): id, descricao, situacao, padrao (default) and desconsiderarSaldo
bling_list_ordersList sales orders (pedidos de venda): id, numero, numeroLoja (marketplace order number), data, dataSaida, dataPrevista, totalProdutos…
bling_get_orderGet one sales order: numero, numeroLoja, dates, contato, situacao, loja, itens (produto, codigo, descricao, quantidade, valor, desconto)…
bling_create_orderCreate a sales order. Required: contato (id), data, dataSaida, dataPrevista, itens and parcelas. Returns data.id. Creating the order does…
bling_update_order_statusChange the status (situacao) of a sales order, for example to Em andamento or Atendido. Valid status ids come from bling_list_statuses for…
bling_delete_orderDelete a sales order permanently. Cannot be undone. Installed switched off
bling_list_status_modulesList the Bling modules that have statuses (situacoes): id, nome and descricao, for example Vendas (sales orders). Use the id with…
bling_list_statusesList the statuses of one module: id, nome, cor and idHerdado (the standard status it derives from). The ids are what bling_list_orders and…
bling_list_contactsList contacts (customers, suppliers and others): id, nome, codigo, situacao, numeroDocumento (CPF or CNPJ), telefone and celular. Search by…
bling_get_contactGet one contact: nome, fantasia, tipo (F, J, E), numeroDocumento, ie, email, emailNotaFiscal, telefone, celular, endereco (geral and…
bling_create_contactCreate a contact (customer or supplier). nome, tipo and situacao are required. Returns data.id
bling_update_contactReplace a contact (PUT: the whole contact is rewritten, fields left out may be emptied). Read it first with bling_get_contact, change what…
bling_list_invoicesList NF-e (electronic invoices): id, tipo (0 entrada, 1 saida), situacao, numero, serie, dataEmissao, dataOperacao, chaveAcesso, contato…
bling_get_invoiceGet one NF-e: numero, serie, situacao, chaveAcesso, dataEmissao, contato, itens with taxes, transporte, parcelas, valorNota, xml (link)…
bling_generate_invoice_from_orderCreate a pending NF-e draft from a sales order (situacao pendente). It is not sent to SEFAZ: issuing is a separate step done in Bling or…
bling_send_invoiceIssue an NF-e: transmit it to SEFAZ for authorization. An authorized NF-e is a legal tax document that can only be cancelled within the…
bling_list_receivablesList accounts receivable (contas a receber): id, situacao, vencimento, valor, saldo, contato, formaPagamento, origem (the order or…
bling_get_receivableGet one account receivable: situacao, vencimento, valor, saldo, dataEmissao, contato, formaPagamento, categoria, origem, boleto and Pix…
bling_list_payablesList accounts payable (contas a pagar): id, situacao, vencimento, valor, contato and origem. Read-only. Up to 100 per page
bling_list_payment_methodsList payment methods (formas de pagamento): id, descricao, tipoPagamento and situacao. The id goes into the parcelas of an order

Example prompts

  • "Which sales orders from today are still open?"
  • "What is the stock of product SKU CAM-PRETA-M in each warehouse?"
  • "Create a draft NF-e from sales order 15873."
  • "Which receivables are due this week, and for how much in BRL?"
  • "Move order 15873 to the status Em andamento."

Next steps

Was this guide helpful?

Connect Bling to Claude, ChatGPT or Copilot in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Bling in the guided setup, then add your MCP URL to your AI assistant. No code and no server to run.

Related guides

Connectors

Connect Bling to ChatGPT via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Claude via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Microsoft Copilot via MCP

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Cursor via MCP: Products and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Gemini CLI via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.

Connectors

Connect Bling to Meta Muse via MCP: Orders and Stock

Bling ERP API v3 (Brazil): products and categories, stock balances and movements, warehouses, sales orders and statuses, contacts, NF-e reads and drafts, accounts receivable and payable (read). Issuing NF-e is switched off. OAuth 2 sign-in with your own Bling app.