io.github.codespar/mcp-bling — MCP Server for Bling

MCP server for Bling, an ERP focused on products, orders, contacts, invoices (NF-e/NFS-e), and stock management. It integrates commerce and finance-related workflows, including AR/AP and webhooks, exposed through the Model Context Protocol. The package is published as @codespar/mcp-bling under the MIT license.

🛠️ Key Features

Bling ERP coverage: products, orders, contacts
Invoices: NF-e and NFS-e
Stock management
AR/AP workflows
Webhooks support

🚀 Use Cases

Retrieve or manage ERP entities like products and orders
Work with electronic invoices (NF-e/NFS-e)
Track stock changes in an ERP context
Integrate AR/AP processes via webhooks

⚡ Developer Benefits

MCP-compatible tooling for LLM apps (Model Context Protocol)
Works with Claude Desktop via MCP server configuration
Requires BLING_ACCESS_TOKEN for authentication

⚠️ Limitations

Setup guidance provided for Claude Desktop configuration only
Details on specific MCP tools/endpoints are not included in the provided data

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "bling": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-bling"],
      "env": {
        "BLING_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

bash

claude mcp add bling -- npx @codespar/mcp-bling

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json

{
  "servers": {
    "bling": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-bling"],
      "env": {
        "BLING_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

Tools (28)

Tool

Purpose

list_products

List products in Bling

create_product

Create a product in Bling

list_categories

List product categories in Bling

create_category

Create a product category in Bling

list_orders

List sales orders in Bling

create_order

Create a sales order in Bling

list_purchase_orders

List purchase orders (pedidos de compras) in Bling

create_purchase_order

Create a purchase order (pedido de compra) in Bling

list_contacts

List contacts (customers/suppliers) in Bling

create_contact

Create a contact in Bling

get_contact

Get a single contact by ID

update_contact

Update an existing contact

list_invoices

List fiscal invoices (NF-e) in Bling

create_invoice

Create a fiscal invoice (NF-e) from an order

send_invoice

Send/emit an already-created NF-e to SEFAZ

create_service_invoice

Create a service invoice (NFS-e) in Bling

get_stock

Get stock/inventory for a product

update_stock

Update stock for a product at a warehouse

create_stock_movement

list_warehouses

List warehouses (depósitos) in Bling

create_warehouse

Create a warehouse (depósito) in Bling

list_accounts_receivable

List accounts receivable (contas a receber)

create_account_receivable

Create an account receivable (conta a receber)

list_accounts_payable

List accounts payable (contas a pagar)

create_account_payable

Create an account payable (conta a pagar)

list_payment_methods

List payment methods (formas de pagamento)

subscribe_webhook

unsubscribe_webhook

Remove a previously registered webhook

Variable

Required

Description

BLING_ACCESS_TOKEN

Yes

OAuth2 access token

Roadmap

v0.3 (planned)

production_management — Manage production orders

multi_store — Multi-store inventory (Mercado Livre, Shopee, Amazon integrations)

list_nfce / create_nfce — Consumer invoice (NFC-e) helpers

Richer filters on list_accounts_* (by payment status, contact)

Install

Configuration

Environment variables

BLING_ACCESS_TOKENrequiredsecret

API key for bling

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-bling": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-bling@0.2.2"
      ],
      "env": {
        "BLING_ACCESS_TOKEN": "<YOUR_BLING_ACCESS_TOKEN>"
      }
    }
  }
}

io.github.codespar/mcp-bling