@codespar/mcp-bling

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

Quick Start

Claude Desktop

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

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

Claude Code

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

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.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 | 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

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

Environment Variables

| 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)

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

Links

• Bling Website
• Bling API Documentation
• MCP Dev Brasil
• Landing Page

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