Mcp Bling

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for Bling — ERP: products, orders, invoices (NF-e/NFS-e), stock, AR/AP, webhooks

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-bling
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-bling.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-bling?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

MCP server for Bling ERP that lets an assistant list and create products, orders, contacts, invoices, stock records, and payables in a Bling account.

What you can do: List and create products and product categories
List and create sales orders and purchase orders
List, get, create and update contacts (customers and suppliers)
List and create fiscal invoices (NF-e), emit an NF-e to SEFAZ, and create service invoices (NFS-e)
Read and update stock per warehouse, register stock movements, and list or create warehouses
List and create accounts receivable and payable, and list payment methods
When to use it: Useful when an assistant should work inside a Brazilian Bling ERP account: looking up catalog, order, contact, invoice, stock or financial records, or drafting new records such as orders, invoices and stock movements from a conversation.
Requirements: Runs locally via npx from the npm package @codespar/mcp-bling (Node.js needed) and is configured in Claude Desktop, Claude Code, Cursor or VS Code. Requires a Bling developer account and an OAuth2 access token supplied in the BLING_ACCESS_TOKEN environment variable. Network access to the Bling API is needed.

Before you install

The token in BLING_ACCESS_TOKEN grants access to a real ERP account; keep it out of shared configs and prefer sandbox credentials for testing. Many tools create or change data, including orders, invoices, contacts, stock levels and accounts payable/receivable, and send_invoice emits a fiscal document to SEFAZ, which is hard to undo. Webhook registration changes account settings. The README also mentions a separate paid enterprise offering.

Installation

In SourceWeft

Open Mcp Bling in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-bling

MCP server for Bling — ERP with products, orders, contacts, invoices, and stock management

[npm] [License: MIT]

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"      }    }  }}

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

Claude Code

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"      }    }  }}

{  "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`	Register a stock-in or stock-out movement for a product (alias of update_stock with explicit direction)
`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`	Register a webhook (notificação) to receive Bling events
`unsubscribe_webhook`	Remove a previously registered webhook

Authentication

Bling uses OAuth2 Bearer tokens for authentication.

Sandbox / Testing

Bling provides a sandbox via the OAuth flow. Use test credentials for development.

Get your credentials

Go to Bling Developer Portal
Create an account
Register an OAuth application and obtain an access token
Set the BLING_ACCESS_TOKEN environment variable

Environment Variables

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)

Want to contribute? Open a PR or request a tool.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/erp/bling/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% 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 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts