# mcp-bling

Connects your assistant to the Bling ERP platform. Lets you query inventory, generate invoices, and handle sales orders via chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/erp/bling
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-bling

## What it does

This server exposes Bling ERP endpoints to MCP assistants. It bundles 28 tools. They cover product catalogs, stock balances, contacts, and purchase orders. It also handles Brazilian fiscal documents, including NF-e emission to SEFAZ and service invoices (NFS-e).

The server manages accounts payable and receivable, webhook subscriptions, and warehouse depots. All calls depend on an active OAuth2 Bearer token. Without `BLING_ACCESS_TOKEN` defined in the environment, the bridge cannot reach the Bling API.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BLING_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-bling -e BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> -- npx -y @codespar/mcp-bling
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add bling --env BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> -- npx -y @codespar/mcp-bling
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bling": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-bling"
            ],
            "env": {
                "BLING_ACCESS_TOKEN": "<BLING_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bling": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-bling"
            ],
            "env": {
                "BLING_ACCESS_TOKEN": "<BLING_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> bling npx -y @codespar/mcp-bling
```
Replace <…> with your own values

## When to use it
- issue and dispatch fiscal NF-e invoices to SEFAZ
- check current product stock across specific warehouses
- record incoming or outgoing inventory movements
- track unpaid accounts receivable and payable

## Example prompts
- Check stock levels for product SKU 1042 across all warehouses
- Create an NF-e invoice for order 4589 and send it to SEFAZ
- List all pending accounts receivable for the current month

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md