mcp-bling — Claude Code MCP server: what it does, how to install
Connects your assistant to the Bling ERP platform. Lets you query inventory, generate invoices, and handle sales orders via chat.
claude mcp add mcp-bling -e BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> -- npx -y @codespar/mcp-blingWhat mcp-bling 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.
What it helps with
- 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 for the agent
- 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
How to install mcp-bling
Platform CLI
claude mcp add mcp-bling -e BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> -- npx -y @codespar/mcp-blingReplace <…> with your own values
Platform CLI
codex mcp add bling --env BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> -- npx -y @codespar/mcp-blingReplace <…> with your own values
Config file
{
"mcpServers": {
"bling": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bling"
],
"env": {
"BLING_ACCESS_TOKEN": "<BLING_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"bling": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bling"
],
"env": {
"BLING_ACCESS_TOKEN": "<BLING_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> bling npx -y @codespar/mcp-blingReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-bling
How to install mcp-bling in Claude Code?
Run claude mcp add mcp-bling -e BLING_ACCESS_TOKEN=<BLING_ACCESS_TOKEN> -- npx -y @codespar/mcp-bling in your terminal. Replace <BLING_ACCESS_TOKEN> with your OAuth2 token from the Bling developer portal.
What does mcp-bling do?
It gives your coding assistant access to 28 tools for interacting with the Bling ERP. Through it, the model can query inventory, draft orders, issue fiscal invoices, and update account balances.
Where do I get the Bling credentials?
You need an OAuth2 app registered at developer.bling.com.br. The resulting Bearer token must be passed to the server via the BLING_ACCESS_TOKEN environment variable.
