@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

| Tool | Description | |------|-------------| | list_products | List products in Bling | | create_product | Create a product in Bling | | list_orders | List sales orders in Bling | | create_order | Create a sales order in Bling | | list_contacts | List contacts (customers/suppliers) in Bling | | create_contact | Create a contact in Bling | | list_invoices | List fiscal invoices (NF-e) in Bling | | create_invoice | Create a fiscal invoice (NF-e) from an order | | get_stock | Get stock/inventory for a product | | update_stock | Update stock for a product at a warehouse |

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.2 (planned)

• create_category — Create a product category
• list_categories — List all product categories
• create_deposit — Create a stock deposit
• list_deposits — List stock deposits
• create_purchase_order — Create a purchase order

v0.3 (planned)

• production_management — Manage production orders
• multi_store — Multi-store inventory management

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

Links

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

License

MIT