Skip to main content
Glama
Business Central MCP Server

Business Central MCP Server

by luisMDev

Business Central MCP Server

License: MIT

A lightweight MCP Server for seamless integration with Microsoft Dynamics 365 Business Central, enabling MCP clients to interact with any entity in your Business Central environment. Developed by sofias tech.

Features

This server provides a clean interface to Business Central resources through the Model Context Protocol (MCP), with optimized HTTP request handling for improved performance.

Tools

The server implements the following tools:

  • BC_Get_Schema: Retrieves the schema of any Business Central entity including available fields

  • BC_List_Items: Fetches a list of entities with optional filtering and pagination

  • BC_Get_Items_By_Field: Searches for entities based on a specific field value

  • BC_Create_Item: Creates a new entity record in Business Central

  • BC_Update_Item: Updates an existing entity record

  • BC_Delete_Item: Removes an entity record from Business Central

Related MCP server: MCP Dataverse Server

Working with Business Central Entities

This server can work with any entity (table) in Business Central. When using the tools, you must provide the exact entity name as it appears in Business Central. For example:

  • Employees

  • Customers

  • Items

  • Vendors

  • SalesOrders

  • Payments

The entity name is case-sensitive and must match exactly what Business Central exposes through its API.

Architecture

The server is built with resource efficiency in mind:

  • Clear separation between resource management and tool implementation

  • Simple and maintainable codebase with minimal code duplication

  • Direct HTTP request handling using requests library

Setup

  1. Create API credentials for Business Central

  2. Configure your Business Central environment and company information

  3. Set up the required environment variables

Environment Variables

The server requires these environment variables:

Quickstart

Installation

pip install -e .

Or install from PyPI once published:

pip install mcp-business-central-server

Using uv:

uv pip install mcp-business-central-server

Claude Desktop Integration

To integrate with Claude Desktop, update the configuration file:

On Windows: %APPDATA%/Claude/claude_desktop_config.json On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Standard Integration

"mcpServers": {
  "businesscentral": {
    "command": "mcp-business-central-server",
    "env": {
      "BC_URL_SERVER": "your-bc-api-url",
      "BC_USER": "your-bc-username",
      "BC_PASS": "your-bc-password",
      "BC_COMPANY": "your-bc-company"
    }
  }
}

Using uvx

"mcpServers": {
  "businesscentral": {
    "command": "uvx",
    "args": [
      "mcp-business-central-server"
    ],
    "env": {
      "BC_URL_SERVER": "your-bc-api-url",
      "BC_USER": "your-bc-username",
      "BC_PASS": "your-bc-password",
      "BC_COMPANY": "your-bc-company"
    }
  }
}

Development

Requirements

  • Python 3.10+

  • Dependencies listed in requirements.txt and pyproject.toml

Local Development

  1. Clone the repository

  2. Create a virtual environment:

    python -m venv .venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  3. Install development dependencies:

    pip install -e .
  4. Create a .env file with your Business Central credentials:

    BC_URL_SERVER=your-bc-api-url
    BC_USER=your-bc-username
    BC_PASS=your-bc-password
    BC_COMPANY=your-bc-company
  5. Run the server:

    python -m mcp_bc_server

Debugging

For debugging the MCP server, you can use the MCP Inspector:

npx @modelcontextprotocol/inspector -- python -m mcp_bc_server

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2025 sofias tech

Available Tools

6 tools
BC_Create_ItemC

Create a new item in Business Central.

Inputs: resource (required), item_data (required). Returns: result

BC_Delete_ItemC

Delete an item from Business Central.

Inputs: resource (required), item_id (required). Returns: result

BC_Get_Items_By_FieldC

Get items matching a field value.

Inputs: resource (required), field (required), value (required). Returns: result

BC_Get_SchemaC

Get schema information for a Business Central resource.

Inputs: resource (required). Returns: result

BC_List_ItemsC

Get items from Business Central with filtering and pagination.

Inputs: resource (required), filter, top, skip. Returns: result

BC_Update_ItemC

Update an existing item in Business Central.

Inputs: resource (required), item_id (required), item_data (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct action on items (create, delete, get by field, get schema, list, update), with no overlap in purpose.

    Naming Consistency4/5

    All tools use a consistent BC_verb_noun pattern in snake_case, though mixing 'Get' and 'List' for item retrieval is a minor inconsistency.

    Tool Count5/5

    Six tools cover the essential CRUD operations plus schema and filtered lookup, which is well-scoped for an item management server.

    Completeness4/5

    Basic CRUD is covered, but there is no explicit get-by-id tool (though BC_Get_Items_By_Field could serve that purpose), leaving a minor gap.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables CRUD operations and schema exploration on Microsoft Dataverse databases using service principal authentication. It allows users to query records with OData filters, manage table entries, and retrieve metadata through a standardized MCP interface.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Model Context Protocol (MCP) server for Microsoft Dynamics 365 Business Central. Provides AI assistants with direct access to Business Central data through properly formatted API v2.0 calls.
      6
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables MCP clients to access and manage Microsoft Dynamics 365 Business Central entities, such as creating sales orders, via a modern async MCP server.
      MIT